numpy.fromregex

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

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

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

Параметры

filestr или файл

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

regexpstr или regexp

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

dtypedtype или список dtype

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

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

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

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

Возвращает

outputndarray

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

Возбуждает

TypeError

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

См. также

fromstring, loadtxt

Примечания

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

Примеры

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