{ } Raw JSON

bundles / numpy 2.4.4 / numpy / fromstring

built-in

numpy:fromstring

Signature

built-in fromstring ( string dtype = <class 'float'> count = -1 * sep like = None )

Summary

A new 1-D array initialized from text data in a string.

Parameters

string : str

A string containing the data.

dtype : data-type, optional

The data type of the array; default: numpy.float64. For binary input data, the data must be in exactly this format. Most builtin numeric types are supported and extension types may be supported.

count : int, optional

Read this number of dtype elements from the data. If this is negative (the default), the count will be determined from the length of the data.

sep : str, optional

The string separating numbers in the data; extra whitespace between elements is also ignored.

like : array_like, optional

Reference object to allow the creation of arrays which are not NumPy arrays. If an array-like passed in as like supports the __array_function__ protocol, the result will be defined by it. In this case, it ensures the creation of an array object compatible with that passed in via this argument.

Returns

arr : ndarray

The constructed array.

Raises

: ValueError

If the string is not the correct size to satisfy the requested dtype and count.

Examples

import numpy as np
np.fromstring('1 2', dtype=int, sep=' ')
np.fromstring('1, 2', dtype=int, sep=',')

See also

frombuffer
fromfile
fromiter

Aliases

  • numpy.fromstring