Método fullmatch do módulo re

O método fullmatch do módulo re busca todas as correspondências com uma expressão regular em uma string. 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, podemos definir sinalizadores (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.fullmatch(expressão_regular, string, [flags])

Exemplo

Vamos aplicar o método fullmatch à nossa string:

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

print(res)

Após executar o código, obteremos None, porque, além dos dígitos, a string também possui caracteres de espaço:

None

Exemplo

Agora, vamos fazer com que nossa string consista apenas de dígitos:

txt = '123456'
res = re.fullmatch('\d+', txt)

print(res)

O resultado da execução do código:

<re.Match object; span=(0, 6), match='123456'>

Veja também

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