Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

re.Match.groupdict — un dizionario dei gruppi con nome

re.Match.groupdict restituisce un dizionario dei gruppi di cattura con nome. Il parametro default fornisce il valore per i gruppi che non hanno partecipato alla corrispondenza.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

match.groupdict(default=None)

Chiama re.Match.groupdict su un oggetto corrispondenza. Restituisce un dizionario che associa i nomi dei gruppi (?P<name>...) ai valori catturati. I gruppi senza nome sono esclusi; se non ci sono gruppi con nome, restituisce {}.

Il parametro default ha valore predefinito None. Sostituisce solo i valori dei gruppi che non hanno partecipato alla corrispondenza, non le stringhe vuote catturate ''.

Controlla prima che la ricerca non abbia restituito None: nessuna corrispondenza non equivale a un dizionario vuoto. Nell’esempio, il gruppo facoltativo tag non partecipa alla corrispondenza. sorted(...items()) rende esplicito l’ordine di visualizzazione.

Esempi

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()))

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti