match, case

Le filtrage par motif : choisir une branche de code d’après les données et la forme d’une valeur.

Sur cette page

Exemple

#
Python
def handle(command):
    match command.split():
        case ["start"]:
            return "Démarrage de la leçon"
        case ["go", direction]:
            return f"Direction {direction}"
        case ["score", *values] if values:
            return f"Total : {sum(map(int, values))}"
        case _:
            return "Commande inconnue"

print(handle("start"))
print(handle("go nord"))
print(handle("score 10 20 5"))
print(handle("fly"))
Résultatrésultat enregistré, vous pouvez le vérifier
Démarrage de la leçon
Direction nord
Total : 35
Commande inconnue

Définition et utilisation

#

L’instruction match (depuis Python 3.10) compare une valeur à des motifs successifs dans des blocs case et exécute le premier qui correspond. Le motif case _: correspond à tout et fonctionne comme else.

Dans les usages simples, elle ressemble au switch d’autres langages. Sa vraie force réside toutefois dans la correspondance de structures : vous pouvez déballer des tuples, des listes et des dictionnaires, combiner des motifs avec | et ajouter des conditions if.

Une correspondance par simple nom de variable fonctionne comme une assignation, pas comme une comparaison. Pour comparer à une constante, utilisez des littéraux ou des noms qualifiés par un point, par exemple Color.RED.

Syntaxe

#
Syntaxe
match value:
    case pattern:
        ...
    case _:
        ...

Plus d’exemples

#
Correspondance sur des dictionnaires
Python
event = {"type": "exercise", "exp": 20}

match event:
    case {"type": "exercise", "exp": exp}:
        print(f"+{exp} EXP pour l’exercice")
    case {"type": "login"}:
        print("Content de vous revoir")
Résultatrésultat enregistré, vous pouvez le vérifier
+20 EXP pour l’exercice

Bonnes pratiques

#
  • Ajoutez toujours une branche case _: pour gérer les valeurs inattendues.
  • Pour une simple comparaison avec quelques valeurs, un dictionnaire peut être plus court que match.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.