numpy.fromstring

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

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

Параметры

stringstr

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

dtypedata-type, optional

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

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

countint, optional

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

sepstr, optional

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

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

likearray_like

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

Примечание

Ключевое слово like — экспериментальная функция, ожидает принятия NEP 35.

Новая в версии 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])