Método search do módulo re

O método search do módulo re busca apenas a primeira correspondência com a expressão regular. No primeiro parâmetro do método especificamos a expressão regular que será buscada, no segundo parâmetro - a string na qual ela será buscada. No terceiro parâmetro opcional, podem ser definidas flags para configurações adicionais da expressão regular. O método retorna um objeto Match object. Se nenhuma correspondência for encontrada, é retornado None.

Sintaxe

import re

re.search(expressão_regular, string, [flags])

Exemplo

Vamos encontrar a primeira substring com dígitos usando o método search:

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

print(res)

Resultado da execução do código:

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

Exemplo

Vamos exibir a correspondência do Match object:

txt = 'aaaa 123 bbbb 456'
res = re.search('\d+', txt)

print(res[0])

Resultado da execução do código:

'123'

Veja também

método findall do módulo re,
que retorna uma lista com todas as correspondências na string
método finditer do módulo re,
que retorna um iterador de todas as correspondências com a expressão regular na string
método match do módulo re,
que busca correspondência com a expressão regular no início da string
método fullmatch do módulo re,
que busca todas as correspondências com a expressão regular na string
objeto Match object do módulo re,
que contém informações sobre as correspondências com a expressão regular