numpy.rec.fromstring#

rec.fromstring(datastring, dtype=None, shape=None, offset=0, formats=None, names=None, titles=None, aligned=False, byteorder=None)[source]#

从二进制数据创建记录数组

请注意,尽管此函数名为 fromstring,但它不接受 str 实例。

参数:
datastring字节类对象

二进制数据缓冲区

dtype数据类型, 可选的

所有数组的有效数据类型

shape整数或整数元组, 可选的

每个数组的形状。

offset整数, 可选的

缓冲区中开始读取的位置。

formats, names, titles, aligned, byteorder

如果 dtypeNone,则这些参数将传递给 numpy.format_parser 以构建 dtype。请参阅该函数的详细文档。

返回:
np.recarray

对 datastring 中数据的记录数组视图。如果 datastring 是只读的,则此视图也将是只读的。

另请参阅

numpy.frombuffer

示例

>>> a = b'\x01\x02\x03abc'
>>> np.rec.fromstring(a, dtype='u1,u1,u1,S3')
rec.array([(1, 2, 3, b'abc')],
        dtype=[('f0', 'u1'), ('f1', 'u1'), ('f2', 'u1'), ('f3', 'S3')])
>>> grades_dtype = [('Name', (np.str_, 10)), ('Marks', np.float64),
...                 ('GradeLevel', np.int32)]
>>> grades_array = np.array([('Sam', 33.3, 3), ('Mike', 44.4, 5),
...                         ('Aadi', 66.6, 6)], dtype=grades_dtype)
>>> np.rec.fromstring(grades_array.tobytes(), dtype=grades_dtype)
rec.array([('Sam', 33.3, 3), ('Mike', 44.4, 5), ('Aadi', 66.6, 6)],
        dtype=[('Name', '<U10'), ('Marks', '<f8'), ('GradeLevel', '<i4')])
>>> s = '\x01\x02\x03abc'
>>> np.rec.fromstring(s, dtype='u1,u1,u1,S3')
Traceback (most recent call last):
   ...
TypeError: a bytes-like object is required, not 'str'