Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

re.Match.groupdict — un dictionnaire de groupes nommés

re.Match.groupdict renvoie un dictionnaire de groupes de capture nommés. Son paramètre default fournit la valeur pour les groupes qui n’ont pas participé à la correspondance.

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

Syntaxe

match.groupdict(default=None)

Appelez re.Match.groupdict sur un objet de correspondance. La méthode renvoie un dictionnaire qui associe les noms des groupes de la forme (?P<name>...) aux valeurs capturées. Les groupes sans nom sont exclus ; en l’absence de groupes nommés, elle renvoie {}.

Le paramètre default vaut par défaut None. Il remplace uniquement les valeurs des groupes qui n’ont pas participé à la correspondance, et non les chaînes vides capturées ''.

Vérifiez d’abord que la recherche n’a pas renvoyé None : aucune correspondance ne signifie pas un dictionnaire vide. Dans l’exemple, le groupe facultatif tag ne participe pas à la correspondance. sorted(...items()) rend explicite l’ordre d’affichage.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources