# Метод match модуля re

Метод `match` модуля `re` ищет только совпадение с регулярным выражением в начале строки. В первом параметре метода указываем регулярку, которую будем искать, во втором параметре - строку, в которой ее ищем. В третьем необязательном параметре можно задать флаги для дополнительных настроек регулярки. Метод возвращает объект Match object. Если совпадения не найдены, возвращается `None`.

## Синтаксис

`import re re.match(регулярка, строка, [флаги])`

## Пример

Давайте найдем все подстроки с цифрами:

`txt = '123 456 789' res = re.match('\d+', txt) print(res)`

Результат выполнения кода:

`<re.Match object; span=(0, 3), match='123'>`

## Пример

А теперь пусть наша строка начинается с буквенных символов:

`txt = 'aaaa 123 456 789' res = re.match('\d+', txt) print(res)`

Результат выполнения кода:

`None`

## Смотрите также

- метод `findall` модуля `re`,
  который возвращает список из всех совпадений в строке
- метод `finditer` модуля `re`,
  который возвращает итератор всех совпадений с регуляркой в строке
- метод `search` модуля `re`,
  который ищет первое совпадение с регуляркой в строке
- метод `fullmatch` модуля `re`,
  который ищет все совпадения с регуляркой в строке
- объект `Match object` модуля `re`,
  который содержит информацию о совпадениях с регуляркой

← →
↑