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.