Функция match() модуля re в Python

Совпадение с регулярным выражением в начале строки

Синтаксис:

import re

re.match(pattern, string, flags=0)

Параметры:

• pattern - строка, шаблон регулярного выражения,
• string - строка для поиска,
• flags=0 - один или несколько флагов.

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

• объект сопоставления

Описание:

Функция match() модуля re возвращает соответствующий объект сопоставления, если ноль или более символов В НАЧАЛЕ СТРОКИ string соответствуют шаблону регулярного выражения pattern.

Функция re.match() возвращает None если строка не соответствует шаблону. Обратите внимание, что это поведение отличается от совпадения нулевой длины.

Важно: даже в re.MULTILINE режиме, re.match() будет совпадать ТОЛЬКО С ПОЗИЦИЕЙ НАЧАЛА СТРОКИ, а не с позицией начала каждой строки.

Если необходимо найти совпадение в любом месте строки, то используйте функцию re.search() вместо re.match().

Дополнительно смотрите отличие функций search() и match().

Примеры использования re.match()

>>> print(re.match('super', 'superstition').span())
# (0, 5)
>>> print(re.match('super', 'insuperable'))
# None