Скомпилированные объекты регулярных выражений re.compile('pattern') поддерживают несколько методов и атрибутов. Здесь будут рассмотрены только самые важные из них. Полный список методов и атрибутов с их описанием смотрите в разделе "Атрибуты и методы cкомпилированного объекта регулярного выражения".
match() - Определяет соответствие шаблону RegExp в начале строки.search() - Сканирует всю строку и ищет все соответствия шаблону RegExp соответствует.findall() - Находит все подстроки, где шаблон RegExp совпадает, и вернуть их в виде списка.finditer() - Находит все подстроки, где шаблон RegExp совпадает, и вернуть их в качестве итератора .Методы скомпилированного объекта match() и search() возвращают None, если совпадение не найдено. Если совпадение найдено, возвращается экземпляр объекта match, содержащий информацию о совпадении: где оно начинается и заканчивается, подстрока, которой оно соответствует, и многое другое.
Если установлен модуль |tkinter| то можно интерактивно экспериментировать с модулем re и запустить демонстрационную программу, которая включена в дистрибутив Python. Она может быть полезна при отладке сложных шаблонов регулярных выражений.
Запустим интерпретатор Python, импортируем модуль re и скомпилируем шаблон регулярного выражения:
>>> import re
>>> p = re.compile('[a-z]+')
>>> p
# re.compile('[a-z]+')
Теперь можно попробовать сопоставить различные строки с регулярным выражением [a-z]+. Пустая строка не должна совпадать вообще, поскольку '+' означает одно или несколько повторений. В этом случае метод match() должен вернуть None и интерпретатор ничего не напечатает. Так же можно явно распечатать результат метода match().
>>> p.match("")
>>> print(p.match(""))
# None
Теперь попробуем подставить строку, которая должна соответствовать скомпилированному шаблону, например tempo. В этом случае методом match() будет возвращен соответствующий объект, который нужно сохранить в переменной для дальнейшего использования.
>>> m = p.match('tempo')
>>> m
# <_sre.SRE_Match object; span=(0, 5), match='tempo'>
Запросим объект для получения информации о соответствующей строке. Экземпляры объекта match() также имеют несколько методов и атрибутов. Самые важные из них:
group() - Вернет строку, совпадающую с регулярным выражением.start() - Вернет индекс строки начала совпадения.end() - Вернет индекс строки конца совпадения.span() - Вернет кортеж, содержащий индексы (start, end) позиции совпадения.>>> m.group()
# 'tempo'
>>> m.start(), m.end()
# (0, 5)
>>> m.span()
# (0, 5)
Поскольку метод match() проверяет только совпадает ли выражение в начале строки, то следовательно start() всегда будет 0. Метод search() сканирует всю строку и заканчивает работу при первом совпадении, поэтому в этом случае совпадение может не начинаться с нуля.
>>> print(p.match('::: message'))
None
>>> m = p.search('::: message'); print(m)
<_sre.SRE_Match object; span=(4, 11), match='message'>
>>> m.group()
'message'
>>> m.span()
(4, 11)
В реальных программах наиболее распространенным стилем является сохранение объекта Match в переменной, а затем проверка его наличия None. Это обычно выглядит так:
p = re.compile( ... )
m = p.match( 'string goes here' )
if m:
print('Match found: ', m.group())
else:
print('No match')
Метод findall() возвращает список всех совпадающих подстрок:
>>> p = re.compile('\d+')
>>> p.findall('12 drummers drumming, 11 pipers piping, 10 lords a-leaping')
# ['12', '11', '10']
Метод findall() создает весь список совпадающих подстрок, прежде чем он возвращает их в качестве результата. Метод finditer() возвращает последовательность объектов совпадений в качестве итератора :
>>> iterator = p.finditer('12 drummers drumming, 11 ... 10 ...')
>>> iterator
# <callable_iterator object at 0x...>
>>> for match in iterator:
... print(match.span())
...
# (0, 2)
# (22, 24)
# (29, 31)