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

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 | None

re.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

Fontes