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

CKTIS / Python

re.Match.groupdict — um dicionário de grupos com nome

re.Match.groupdict devolve um dicionário de grupos de captura com nome. O parâmetro default fornece o valor para os grupos que não participaram na correspondência.

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

Sintaxe

match.groupdict(default=None)

Chame re.Match.groupdict num objeto de correspondência. Devolve um dicionário que associa os nomes dos grupos (?P<name>...) aos valores capturados. Os grupos sem nome são excluídos; se não existirem grupos com nome, devolve {}.

O parâmetro default tem o valor predefinido None. Substitui apenas os valores dos grupos que não participaram na correspondência, não as cadeias vazias capturadas ''.

Verifique primeiro se a pesquisa não devolveu None: não haver correspondência não é o mesmo que obter um dicionário vazio. No exemplo, o grupo opcional tag não participa na correspondência. sorted(...items()) torna explícita a ordem de apresentação.

Exemplos

import re

match = re.fullmatch(r"(?P<name>[A-Za-z]+)(?:-(?P<tag>[0-9]+))?", "Ada")
if match is None:
    raise ValueError("No match")

print(sorted(match.groupdict().items()))
print(sorted(match.groupdict(default="missing").items()))

Resultado

[('name', 'Ada'), ('tag', None)]
[('name', 'Ada'), ('tag', 'missing')]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes