numpy.fromregex

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

Создаёт массив из текстового файла с использованием разбора по регулярному выражению.

Возвращаемый массив всегда является структурированным массивом и создаётся из всех совпадений регулярного выражения в файле. Группы в регулярном выражении преобразуются в поля структурированного массива.

Параметры:

filefile, str или pathlib.Path

Имя файла или объект файла для чтения.

Изменено в версии 1.22.0: Теперь принимает реализации os.PathLike.

regexpstr или regexp

Регулярное выражение, используемое для разбора файла. Группы в регулярном выражении соответствуют полям в dtype.

dtypedtype или список dtypes

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

encodingstr, необязательно

Кодировка, используемая для декодирования входного файла. Не применяется к входным потокам.

Добавлена в версии 1.14.0.

Возвращаемое значение:

outputndarray

Массив вывода, содержащий часть содержимого file, которая была сопоставлена с regexp. output всегда является структурированным массивом.

Исключения:

TypeError

Когда dtype не является допустимым типом данных для структурированного массива.

См. также

fromstring, loadtxt

Примечания

Типы данных для структурированных массивов могут быть заданы в нескольких формах, но все формы указывают по крайней мере тип данных и имя поля. Подробности см. в basics.rec.

Примеры

>>> 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])