numpy.fromregex#

numpy.fromregex(file, regexp, dtype, encoding=None)[source]#

使用正则表达式解析从文本文件构造数组。

返回的数组始终是结构化数组,它由文件中正则表达式的所有匹配项构建。正则表达式中的组将转换为结构化数组的字段。

参数:
file文件、字符串或 pathlib.Path

要读取的文件名或文件对象。

在 1.22.0 版本中更改: 现在接受 os.PathLike 实现。

regexp字符串或正则表达式

用于解析文件的正则表达式。正则表达式中的组对应于 dtype 中的字段。

dtypedtype 或 dtype 列表

结构化数组的 dtype;必须是结构化数据类型。

encoding字符串,可选

用于解码输入文件的编码。不适用于输入流。

在 1.14.0 版本中新增。

返回值:
outputndarray

输出数组,包含 file 内容中由 regexp 匹配的部分。 output 始终是结构化数组。

引发:
TypeError

dtype 不是结构化数组的有效 dtype 时。

另请参阅

fromstring, loadtxt

注释

结构化数组的 Dtypes 可以通过几种形式指定,但所有形式至少指定数据类型和字段名。有关详细信息,请参阅 basics.rec

示例

>>> import numpy as np
>>> from io import StringIO
>>> text = StringIO("1312 foo\n1534  bar\n444   qux")
>>> regexp = r"(\d+)\s+(...)"  # match [digits, whitespace, anything]
>>> output = np.fromregex(text, regexp,
...                       [('num', np.int64), ('key', 'S3')])
>>> output
array([(1312, b'foo'), (1534, b'bar'), ( 444, b'qux')],
      dtype=[('num', '<i8'), ('key', 'S3')])
>>> output['num']
array([1312, 1534,  444])