Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

re.Match.groupdict — słownik nazwanych grup

re.Match.groupdict zwraca słownik nazwanych grup dopasowania. Parametr default określa wartość dla grup, które nie uczestniczyły w dopasowaniu.

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

Składnia

match.groupdict(default=None)

re.Match.groupdict wywołuje się na obiekcie dopasowania. Zwraca słownik z nazwami grup (?P<name>...) jako kluczami i przechwyconymi wartościami. Pomija grupy bez nazw; bez nazwanych grup zwraca {}.

Parametr default domyślnie wynosi None. Zastępuje tylko wartości grup, które nie uczestniczyły w dopasowaniu, a nie dopasowane puste ciągi ''.

Najpierw sprawdź, czy wyszukiwanie nie zwróciło None: brak dopasowania nie jest pustym słownikiem. W przykładzie opcjonalna grupa tag nie uczestniczy w dopasowaniu. sorted(...items()) zapewnia jawną kolejność prezentacji.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła