CKTIS / Python
re.Pattern.search: encontrar a primeira correspondência com um padrão compilado
Usa uma expressão regular compilada para encontrar a primeira correspondência numa cadeia de caracteres ou num intervalo delimitado por índices.
Versão: Python 3.12
Sintaxe
pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.search é um método do objeto devolvido por re.compile(). A chamada pattern.search(string) devolve um objeto re.Match para a primeira posição em que o padrão encontra uma correspondência, mesmo a meio da cadeia. Já pattern.match() só tenta fazer corresponder o padrão na posição inicial, e pattern.fullmatch() exige que todo o intervalo indicado corresponda ao padrão.
O índice opcional pos indica onde começa a pesquisa e tem o valor predefinido 0. endpos é o limite superior excluído e, por omissão, corresponde ao comprimento da cadeia. No CPython 3.12, os valores de pos e endpos são limitados ao intervalo entre 0 e o comprimento da cadeia, incluindo ambos os limites. Se endpos < pos após esse ajuste, o método devolve None. Definir pos não equivale a extrair uma parte da cadeia: a âncora ^ não trata pos como um novo início da cadeia.
Verifica match is not None antes de leres o resultado. Uma correspondência de comprimento zero continua a ser um objeto re.Match. match.group(0) devolve toda a subcadeia correspondente, e match.span() devolve os índices (início, fim) na cadeia original, com o índice final excluído.
A função do módulo re.search(pattern, string, flags=0) recebe o padrão como argumento e não tem parâmetros pos nem endpos. O método usa o padrão já guardado no objeto compilado, que podes reutilizar. Passa as opções como argumentos a re.compile(), não a pattern.search().
Exemplos
import re
pattern = re.compile(r"[A-Z][0-9]{2}")
text = "IDs: A17, B42"
for match in (pattern.search(text), pattern.search(text, pos=8)):
if match is not None:
print(match.group(0), match.span())
print(pattern.search(text, pos=8, endpos=12))Resultado
A17 (5, 8) B42 (10, 13) None
O padrão reconhece uma letra maiúscula ASCII seguida de dois algarismos ASCII. A primeira chamada encontra `A17`; com `pos=8`, a pesquisa ignora-o e encontra `B42`. Com `endpos=12`, o `2` final fica fora do intervalo de pesquisa, pelo que o resultado é `None`.
Lições relacionadas
- Python · Lição 30 · Intermédio · Versão: 3