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,tuplede 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 degetquand l'absence est normale.- dict.get
d.get(cle)renvoieNonesi 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()etd.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
dictconserve 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 ;Countercompte les occurrences d'un itérable en une ligne et offremost_common().
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.