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

CKTIS / Python

re.Pattern

O objeto devolvido por re.compile conserva o padrão, as opções e os dados dos grupos.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

p = re.compile(pattern)
p.search(string, pos, endpos)

O objeto devolvido por re.compile conserva o padrão, as opções e os dados dos grupos.

pattern contém o padrão, flags as opções ativas, groups o número de grupos de captura e groupindex associa os nomes dos grupos aos números. search aceita pos e endpos para limitar a procura sem criar uma subcadeia. Os índices referem-se ao original e pos não redefine o início para ^.

A partir da posição 1 o padrão ignora 3 e encontra 17 em (3, 5).

import re
p = re.compile("ab")
assert isinstance(p, re.Pattern)
assert p.search("ab-ab", 1, 5).span() == (3, 5)
assert p.search("ab-ab", 1, 4) is None
assert re.compile("^ab").search("xaba", 1) is None
p = re.compile(r"(?P<id>\d+)", re.I)
assert p.pattern == r"(?P<id>\d+)" and p.flags & re.I and p.groups == 1 and p.groupindex == {"id": 1}

re.Pattern.fullmatch · re.Pattern.search · re.Pattern.sub

fullmatch exige todo o intervalo escolhido e search encontra nele a primeira correspondência. Ambos devolvem Match ou None. sub substitui correspondências sem sobreposição por um modelo ou pelo resultado de uma função para cada Match. Um count positivo limita as substituições.

import re
p=re.compile(r'[A-Z]+')
assert p.fullmatch('QA').group()=='QA' and p.fullmatch('id QA') is None
assert p.search('id QA').span()==(3,5) and p.search('id') is None
assert p.sub(lambda m:m.group().lower(),'QA: DEV',count=1)=='qa: DEV'

Exemplos

import re
pattern = re.compile(r"\d+")
print(isinstance(pattern, re.Pattern))
print(pattern.search("3 a17", 1).span())

Resultado

True
(3, 5)

A partir da posição 1 o padrão ignora 3 e encontra 17 em (3, 5).

Fontes