numpy.fromregex

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

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

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

Параметры

filestr or file

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

regexpstr or regexp

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

dtypedtype or list of dtypes

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

encodingstr, optional

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

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

Возвращает

outputndarray

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

Возможные исключения

TypeError

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

См. также

fromstring, loadtxt

Примечания

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

Примеры

>>> f = open('test.dat', 'w')
>>> _ = f.write("1312 foo\n1534  bar\n444   qux")
>>> f.close()

>>> regexp = r"(\d+)\s+(...)"  # match [digits, whitespace, anything]
>>> output = np.fromregex('test.dat', 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])