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

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

## Синтаксис

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

## Пример

Давайте найдем первую подстроку с цифрами с помощью метода `search`:

`txt = 'aaa 123 bbb 456' res = re.search('\d+', txt) print(res)`

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

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

## Пример

Давайте выведем совпадение из Match object:

`txt = 'aaaa 123 bbbb 456' res = re.search('\d+', txt) print(res[0])`

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

`'123'`

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

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

← →
↑