UNICODE U

Делает классы r\w, r\W, r\b и r\B интернациональными (в соответствии с классами символов в Unicode). Опция доступна, начиная с версии 1.6.

Приведенные ниже функции воспринимают в качестве аргумента pattern как строку, так и объект, представляющие компилированное регулярное выражение. Если необходимо установить флаги, используйте компилированное регулярное выражение или специальную последовательность вида (? flags) в строке.

search( pattern, string [, flags])

Ищет в строке string позицию, в которой она удовлетворяет регулярному выражению pattern и возвращает объект, представляющий результат сопоставления. Если такая позиция не найдена, возвращает None.

match( pattern, string [, flags])

Если 0 или более символов в начале строки string удовлетворяют регулярному выражению pattern, возвращает объект, представляющий результат сопоставления, в противном случае возвращает None.

split( pattern, string [, maxsplit ])

Разбивает строку string в местах, удовлетворяющих регулярному выражению pattern и возвращает результат в виде списка. Если pattern содержит группирующие скобки, то текст групп также включается в возвращаемый список. Если задан и не равен 0 аргумент maxsplit , выполняется не более maxsplit расщеплений и остаток строки помещается в конец списка. Например:

>>> re.split(\W+, Words, words, words.)

[Words, words, words, ]

>>> re.split((\W+), Words, words, words.)

[Words, , , words, , , words, ., ] >>> re.split(\W+, Words, words, words., l)

[Words, words, words.]

findall( pattern, string)

Возвращает список непересекающихся фрагментов строки string, удовлетворяющих регулярному выражению pattern. Если pattern содержит группы, элементами списка будут строки, удовлетворяющие группе, или кортеж строк, если групп в шаблоне несколько. Результаты сопоставления с нулевой длиной также включаются в результат.

sub( pattern, repl , string [, count ])

Возвращает строку, полученную заменой непересекающихся фрагментов строки string, удовлетворяющих регулярному выражению pattern, на repl . Если не найдено ни одного такого фрагмента, строка возвращается неизменной. repl может быть строкой или функцией. Функция должна воспринимать один аргумент - объект, представляющий результат сопоставления, и возвращать строку для замены. Например:

16.2.4 Объекты, представляющие регулярные выражения

Компилированные объекты регулярных выражений имеют следующие методы и атрибуты данных:

search( string [, pos [, endpos]])

Ищет в строке string позицию, в которой она удовлетворяет регулярному выражению и возвращает объект, представляющий результат сопоставления. Если такая позиция не найдена, возвращает None. Необязательные аргументы pos и endpos имеют такое же значение, как и для метода match() , описанного ниже.

match( string [, pos [, endpos]])

Если 0 или более символов в начале строки string удовлетворяют регулярному выражению, возвращает объект, представляющий результат сопоставления, в противном случае возвращает None.

>>> def dashrepl(matchobj):

.... if matchobj.group(0) == return

.... else: return -

>>> re.sub(-{1,2}, dashrepl, pro----gram-files)

pro--gram files

Если задан и не равен 0 аргумент count, он определяет максимальное число производимых замен. По умолчанию число замен не ограничено.

Замена удовлетворяющего регулярному выражению фрагмента нулевой длины производится только в том случае, если он не является смежным с предыдущим таким фрагментом. Таким образом, sub(x*, -, abc) возвращает -a-b-c-.

Если repl является строкой, то обрабатываются содержащиеся в ней специальные последовательности, представляющие символы или ссылки на группы. Например, r\n заменяется символом новой строки, r\6 (или r\g<6>) - фрагментом, удовлетворяющим шестой группе, и r\g<id> - фрагментом, удовлетворяющим группе с именем id.

subn (pattern, repl, string [, count])

Выполняет те же самые операции, что и функция sub() , но возвращает кортеж, состоящий из новой строки и числа произведенных замен.

escape( string)

Возвращает регулярное выражение, пригодное для поиска вхождений строки string, то есть записывает с использованием обратной косой черты символы строки, имеющие специальное значение в регулярных выражения.

error

Класс исключений, которые генерируются, если используемое регулярное выражение содержит ошибки (например, несоответствие группирующих скобок), а также при возникновении некоторых других ошибок. Несоответствие строки шаблону никогда не является ошибкой.

16.2.5 Объекты, представляющие результат сопоставления

Объекты, возвращаемые методами search() и match() компилированных регулярных выражений, а также одноименными функциями, имеют следующие методы и атрибуты данных:

group ([groupl [, group2 ...]])

Возвращает один или более фрагментов, которые при выполнении операции сопоставления удовлетворили определениям одной или нескольких групп. Числа groupN указывают на группы с номерами от 1 до 99 или на фрагмент, удовлетворяющий всему регулярному выражению (группа с номером 0). groupN может

Необязательный аргумент pos (по умолчанию равен 0 ) указывает позицию в строке, начиная с которой необходимо выполнять сопоставление. Использование этого аргумента не эквивалентно вызову метода для string [pos:], так как в первом случае специальные последовательности и r\A удовлетворяют началу реальной строки. Аналогично аргумент endpos указывает позицию в строке, до которой будет выполняться сопоставление.

split( string [, maxsplit ])

Вызов этого метода эквивалентен вызову функции split() с объектом, представляющим регулярное выражение, в качестве первого аргумента.

findall( string)

Вызов этого метода эквивалентен вызову функции findall() с объектом, представляющим регулярное выражение, в качестве первого аргумента.

sub( repl , string [, count ])

Вызов этого метода эквивалентен вызову функции sub() с объектом, представляющим регулярное выражение, в качестве первого аргумента.

subn( repl , string [, count ])

Вызов этого метода эквивалентен вызову функции subn() с объектом, представляющим регулярное выражение, в качестве первого аргумента.

flags

Значение аргумента flags, переданного функции compile() при компиляции объекта. Этот атрибут не отражает флаги, установленные с помощью специальных последовательностей в самом регулярном выражении.

groupindex

Словарь, отображающий имена групп к их номерам (пустой, если регулярное выражение не содержит именованных групп).

pattern

Строка, содержащая регулярное выражение, которое было использовано при компиляции объекта.