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 时。
另请参阅
注释
结构化数组的 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])