collections.defaultdict

Un dictionnaire qui crée de lui-même une valeur par défaut pour une clé absente, par exemple une liste vide ou zéro.

Renvoie
Un objet defaultdict, c’est-à-dire un dictionnaire avec des valeurs par défaut automatiques.
Sur cette page

Exemple

#
Python
from collections import defaultdict

topics = [("HTML", "balises"), ("CSS", "flexbox"), ("HTML", "formulaires")]

by_course = defaultdict(list)
for course, topic in topics:
    by_course[course].append(topic)

print(by_course["HTML"])
print(dict(by_course))
Résultatrésultat enregistré, vous pouvez le vérifier
['balises', 'formulaires']
{'HTML': ['balises', 'formulaires'], 'CSS': ['flexbox']}

Définition et utilisation

#

La classe defaultdict du module collections fonctionne comme un dictionnaire ordinaire, mais à la lecture d’une clé absente, elle ne lève pas KeyError. Elle appelle à la place la fonction donnée à la création, enregistre son résultat sous cette clé et le renvoie.

On passe la fonction sans parenthèses : defaultdict(list) crée une liste vide pour les nouvelles clés, defaultdict(int) zéro, et defaultdict(set) un ensemble vide. Vous pouvez aussi passer votre propre fonction, par exemple defaultdict(lambda: "aucun").

Les usages les plus courants sont le regroupement (groups[key].append(item)) et la somme (totals[key] += value) sans vérifier si la clé existe déjà. N’oubliez pas que la simple lecture d[clé] ajoute aussi la clé absente. La méthode get() et l’opérateur in ne le font pas.

Syntaxe

#
Syntaxe
from collections import defaultdict

defaultdict(default_factory)
defaultdict(list)
defaultdict(int)

Paramètres

#
  • default_factory

    fonction sans argument ou None

    Crée la valeur pour une clé absente, par exemple list donne [], et int donne 0. Avec None, le dictionnaire se comporte comme un dict ordinaire.

Plus d’exemples

#
Sommer avec int
Python
from collections import defaultdict

points = defaultdict(int)
for name, exp in [("Léa", 20), ("Jean", 15), ("Léa", 10)]:
    points[name] += exp

print(points)
print(points["Mia"])
Résultatrésultat enregistré, vous pouvez le vérifier
defaultdict(<class 'int'>, {'Léa': 30, 'Jean': 15})
0
Un piège : la lecture crée aussi la clé
Python
from collections import defaultdict

scores = defaultdict(list)
print(scores["Mia"])
print("Mia" in scores, len(scores))

print(scores.get("Zoé"), len(scores))
Résultatrésultat enregistré, vous pouvez le vérifier
[]
True 1
None 1

Bonnes pratiques

#
  • Pour vérifier si une clé existe, utilisez in ou get(). La lecture avec des crochets ajoutera la clé absente.
  • Avant de transmettre le résultat, convertissez-le en dictionnaire ordinaire avec dict(). Il s’affiche plus clairement, et une lecture accidentelle d’une clé absente n’ajoutera plus d’entrée.
  • Pour simplement compter des éléments, Counter est encore plus pratique.

Entrées associées

#

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