CKTIS / Python
re.Match.groupdict — een dictionary van groepen met naam
re.Match.groupdict retourneert een dictionary van benoemde vanggroepen. De parameter default levert de waarde voor groepen die niet aan de match hebben deelgenomen.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
match.groupdict(default=None)Roep re.Match.groupdict aan op een match-object. De methode retourneert een dictionary die namen uit groepen van de vorm (?P<name>...) koppelt aan de vastgelegde waarden. Groepen zonder naam worden weggelaten; zonder benoemde groepen retourneert de methode {}.
De parameter default heeft standaard de waarde None. Deze vervangt alleen de waarden van groepen die niet aan de match hebben deelgenomen, en niet vastgelegde lege tekenreeksen ''.
Controleer eerst of de zoekactie niet None heeft geretourneerd: geen match is niet hetzelfde als een lege dictionary. In het voorbeeld neemt de optionele groep tag niet deel aan de match. sorted(...items()) maakt de weergavevolgorde expliciet.
Voorbeelden
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()))Resultaat
[('name', 'Ada'), ('tag', None)]
[('name', 'Ada'), ('tag', 'missing')]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.