WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

re.Match.groupdict — ein Wörterbuch benannter Gruppen

re.Match.groupdict gibt ein Wörterbuch benannter Fanggruppen zurück. Der Parameter default legt den Wert für Gruppen fest, die nicht am Treffer beteiligt waren.

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

Syntax

match.groupdict(default=None)

Rufe re.Match.groupdict für ein Match-Objekt auf. Die Methode gibt ein Wörterbuch zurück, das Namen aus Gruppen der Form (?P<name>...) den erfassten Werten zuordnet. Gruppen ohne Namen werden ausgelassen; gibt es keine benannten Gruppen, wird {} zurückgegeben.

Der Parameter default hat standardmäßig den Wert None. Er ersetzt nur die Werte von Gruppen, die nicht am Treffer beteiligt waren, nicht aber erfasste leere Zeichenfolgen ''.

Prüfe zuerst, ob die Suche None zurückgegeben hat: Kein Treffer ist nicht dasselbe wie ein leeres Wörterbuch. Im Beispiel ist die optionale Gruppe tag nicht am Treffer beteiligt. sorted(...items()) macht die Reihenfolge der Ausgabe ausdrücklich fest.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen