numpy.fromstring

numpy.fromstring(string, dtype=float, count=- 1, sep='', *, like=None)

Новая 1-мерная массив, инициализированная данными из строки.

Параметры

stringstr

Строка, содержащая данные.

dtypeтип данных, необязательно

Тип данных массива; по умолчанию: float. Для двоичных входных данных данные должны быть в этом формате. Поддерживаются большинство встроенных числовых типов и, возможно, расширенные типы.

Добавлена в версии 1.18.0: Комплексные типы данных.

countint, необязательно

Прочитать это количество элементов dtype из данных. Если это значение отрицательное (по умолчанию), количество будет определено по длине данных.

sepstr, необязательно

Строка, разделяющая числа в данных; дополнительные пробелы между элементами также игнорируются.

Устарело начиная с версии 1.14: Передача sep='', по умолчанию, устарела, поскольку она приведет к использованию устаревшего двоичного режима этой функции. Этот режим интерпретирует string как двоичные байты, а не ASCII-текст с десятичными числами, операция, которая лучше выражается как frombuffer(string, dtype, count). Если string содержит текст Unicode, двоичный режим fromstring сначала закодирует его в байты, используя utf-8 (python 3) или кодировку по умолчанию (python 2), ни один из которых не дает осмысленных результатов.

likearray_like

Объект ссылки для создания массивов, которые не являются массивами NumPy. Если переданный в качестве like массив-подобный объект поддерживает протокол __array_function__, результат будет определен им. В этом случае гарантируется создание объекта массива, совместимого с тем, который передан с помощью этого аргумента.

Добавлена в версии 1.20.0.

Возвращает

arrndarray

Созданный массив.

Возможные исключения

ValueError

Если строка не имеет правильного размера для удовлетворения запрошенного dtype и count.

См. также

frombuffer, fromfile, fromiter

Примеры

>>> np.fromstring('1 2', dtype=int, sep=' ')
array([1, 2])
>>> np.fromstring('1, 2', dtype=int, sep=',')
array([1, 2])