Formations — 1 037 leçons en français

Accueil › Python › Dictionnaires : clés, valeurs et le piège du KeyError

Dictionnaires : clés, valeurs et le piège du KeyError

Listes, dictionnaires et ensemblesdebutant

Un dictionnaire associe des clés à des valeurs. On y accède par la clé, pas par une position.

stock = {
    "CAFE-001": 40,
    "THE-002": 12,
}

print(stock["CAFE-001"])     # 40
stock["SUCRE-003"] = 7       # ajoute
stock["THE-002"] = 15        # écrase
print(len(stock))            # 3
print("THE-002" in stock)    # True — « in » porte sur les CLÉS

L'accès direct lève une erreur si la clé manque :

print(stock["MIEL-004"])     # KeyError: 'MIEL-004'

C'est voulu : une clé absente est souvent un bug. Mais quand l'absence est un cas normal, utilisez get :

print(stock.get("MIEL-004"))        # None
print(stock.get("MIEL-004", 0))     # 0 — le défaut à préciser dès qu'on calcule

Pour parcourir, trois vues :

for reference in stock:                    # les clés
    ...
for quantite in stock.values():            # les valeurs
    ...
for reference, quantite in stock.items():  # les deux — la forme la plus utile
    print(f"{reference} : {quantite}")

Les clés doivent être hachables (str, int, tuple…), elles sont uniques, et depuis Python 3.7 l'ordre d'insertion est conservé.

Les termes à connaître

dict

Une table d'association clé → valeur, écrite entre accolades : {"CAFE-001": 40}. L'accès par clé est en temps constant en moyenne, quelle que soit la taille du dictionnaire.

Clé

Doit être hachable : str, int, float, bool, tuple de hachables. Une liste ou un dictionnaire ne peuvent pas servir de clé. Les clés sont uniques : réaffecter une clé existante écrase sa valeur.

KeyError

L'erreur levée par d["absente"] quand la clé n'existe pas : KeyError: 'absente'. Le message ne contient que la clé, sans indication du dictionnaire concerné — d'où l'intérêt de get quand l'absence est normale.

dict.get

d.get(cle) renvoie None si la clé manque, d.get(cle, defaut) renvoie la valeur de repli indiquée. Jamais d'erreur. C'est le bon outil quand l'absence d'une clé est un cas prévu, pas une anomalie.

dict.setdefault

d.setdefault(cle, defaut) renvoie la valeur existante, ou insère le défaut et le renvoie. Idéal pour accumuler : groupes.setdefault(ville, []).append(client).

Vues (`keys`, `values`, `items`)

d.keys(), d.values() et d.items() renvoient des vues dynamiques, pas des listes : elles reflètent les modifications du dictionnaire et ne peuvent pas être indexées. list(d.keys()) les matérialise.

Ordre d'insertion

Depuis Python 3.7, un dict conserve l'ordre dans lequel les clés ont été insérées — c'est une garantie du langage, plus un détail d'implémentation. Mais il ne se trie pas tout seul.

defaultdict et Counter

Deux dictionnaires spécialisés du module collections. defaultdict(list) crée la valeur manquante à la volée ; Counter compte les occurrences d'un itérable en une ligne et offre most_common().

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.