Método match do módulo re

O método match do módulo re busca apenas uma correspondência com expressão regular no início da string. No primeiro parâmetro do método especificamos a expressão regular que vamos buscar, no segundo parâmetro - a string na qual iremos buscá-la. No terceiro parâmetro opcional podemos definir sinalizadores 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.match(expressão_regular, string, [sinalizadores])

Exemplo

Vamos encontrar todas as substrings com dígitos:

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

print(res)

Resultado da execução do código:

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

Exemplo

Agora vamos fazer com que nossa string comece com caracteres alfabéticos:

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

print(res)

Resultado da execução do código:

None

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 search do módulo re,
que busca a primeira correspondência com a expressão regular na 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