Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

re.Pattern.fullmatch: verificar a cadeia de caracteres completa

Este método de uma expressão regular compilada verifica se o padrão corresponde à cadeia de caracteres inteira ou a todo o intervalo delimitado por `pos` e `endpos`.

Versão: Python 3.12

Sintaxe

compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.fullmatch é um método do objeto devolvido por re.compile(). Se não forem indicados limites, o padrão tem de abranger toda a cadeia de caracteres. O método devolve um objeto re.Match se houver correspondência e None caso contrário. Uma correspondência de comprimento zero também conta; usa result is not None para verificar se houve correspondência.

O índice opcional pos define o início (por omissão, 0) e endpos define o fim, excluído do intervalo (por omissão, len(string)). A correspondência tem de abranger todo esse intervalo. No CPython 3.12, ambos os índices são ajustados ao intervalo de 0 a len(string), incluindo os extremos. Se, após esse ajuste, endpos for inferior a pos, não há correspondência. Se os valores resultantes forem iguais, pode haver uma correspondência de comprimento zero. span() devolve os índices na cadeia original. Definir limites não equivale a extrair uma subcadeia: por exemplo, ^ não trata pos como um novo início da cadeia.

Usa Pattern.match() se bastar uma correspondência no início do intervalo, ou Pattern.search() para encontrar uma em qualquer ponto do intervalo. A função do módulo re.fullmatch(pattern, string, flags=0) recebe o padrão como argumento, mas não disponibiliza pos nem endpos. O método usa o padrão já compilado e as suas opções; não aceita o argumento flags.

Exemplos

import re

code_pattern = re.compile(r"[A-Z]{2}-[0-9]{2}")

print(code_pattern.fullmatch("AB-42") is not None)
print(code_pattern.fullmatch("AB-42!") is not None)

match = code_pattern.fullmatch("[AB-42]", 1, 6)
assert match is not None
print(match.span())

Resultado

True
False
(1, 6)

O padrão exige duas letras maiúsculas ASCII, um hífen e dois algarismos ASCII. `AB-42` corresponde ao padrão, mas `AB-42!` não. Em `[AB-42]`, o intervalo de `1` inclusive a `6` exclusive deixa de fora ambos os parênteses retos, pelo que `span()` devolve `(1, 6)`.

Lições relacionadas

  • Python · Lição 29 · Intermédio · Versão: 3

Fontes