numpy.fromstring#

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

一个从字符串中的文本数据初始化的新一维数组。

参数:
stringstr

包含数据的字符串。

dtypedata-type, optional

数组的数据类型;默认值:float。对于二进制输入数据,数据必须完全以此格式存在。大多数内置数字类型受支持,扩展类型也可能受支持。

countint, optional

从数据中读取此数量的 dtype 元素。如果此值为负数(默认值),则计数将根据数据的长度确定。

sepstr, optional

数据中数字的分隔符;元素之间的额外空白符也会被忽略。

自 1.14 版本弃用:传递 sep=''(默认值)已被弃用,因为它将触发此函数的已弃用二进制模式。此模式将 string 解释为二进制字节,而非带十进制数的 ASCII 文本,此操作最好写为 frombuffer(string, dtype, count)。如果 string 包含 Unicode 文本,fromstring 的二进制模式将首先使用 utf-8 将其编码为字节,这不会产生合理的结果。

likearray_like, optional

参考对象,允许创建非 NumPy 数组。如果作为 like 传入的类数组对象支持 __array_function__ 协议,则结果将由其定义。在这种情况下,它确保创建与通过此参数传入的对象兼容的数组对象。

1.20.0 版本新增。

返回:
arrndarray

构建的数组。

抛出:
ValueError

如果字符串的大小不正确,无法满足请求的 dtypecount

另请参阅

frombuffer, fromfile, fromiter

示例

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