collections.Counter

Un dictionnaire pour compter : pour chaque élément, il garde le nombre de ses occurrences.

Renvoie
Un objet Counter, c’est-à-dire un dictionnaire de nombres d’occurrences.
Sur cette page

Exemple

#
Python
from collections import Counter

answers = ["B", "A", "B", "C", "B", "A"]
counts = Counter(answers)

print(counts)
print(counts["B"], counts["D"])
print(counts.most_common(1))
Résultatrésultat enregistré, vous pouvez le vérifier
Counter({'B': 3, 'A': 2, 'C': 1})
3 0
[('B', 3)]

Définition et utilisation

#

La classe Counter du module collections compte les éléments d’une collection en une seule étape. Counter(["a", "b", "a"]) crée un dictionnaire dont les clés sont les éléments et les valeurs le nombre de leurs occurrences. Elle fonctionne avec des listes, des chaînes (elle compte les caractères) et toute autre collection.

La méthode most_common(n) renvoie la liste des n éléments les plus fréquents avec leur nombre d’occurrences, triée du plus grand au plus petit. La lecture d’une clé absente renvoie 0 au lieu de lever KeyError, il n’y a donc rien à vérifier avant d’incrémenter un compteur.

Counter est une sous-classe de dict, tout ce que vous connaissez des dictionnaires fonctionne donc avec elle. De plus, on peut additionner et soustraire des compteurs avec les opérateurs + et -, et la méthode update() ajoute de nouvelles occurrences au lieu de remplacer les valeurs. La somme de tous les compteurs est renvoyée par total().

Syntaxe

#
Syntaxe
from collections import Counter

Counter(iterable)
compteur.most_common(n)
compteur.update(iterable)
compteur.total()

Paramètres

#
  • iterable

    collection ou dictionnaire, facultatif

    Les éléments à compter, ou un dictionnaire avec des compteurs déjà prêts.

Plus d’exemples

#
Les mots les plus fréquents d’un texte
Python
from collections import Counter

text = "python est simple et python est populaire"
words = Counter(text.split())

for word, count in words.most_common(2):
    print(word, count)

print(Counter("banan"))
Résultatrésultat enregistré, vous pouvez le vérifier
python 2
est 2
Counter({'a': 2, 'n': 2, 'b': 1})
Addition et mise à jour de compteurs
Python
from collections import Counter

week1 = Counter(html=3, python=1)
week2 = Counter(python=4, css=2)

print(week1 + week2)

week1.update(["html", "css"])
print(week1)
print(week1.total())
Résultatrésultat enregistré, vous pouvez le vérifier
Counter({'python': 5, 'html': 3, 'css': 2})
Counter({'html': 4, 'python': 1, 'css': 1})
6

Bonnes pratiques

#
  • La lecture d’une clé absente renvoie 0, mais ne l’ajoute pas au compteur. C’est pourquoi counts[x] += 1 fonctionne sans vérifier la clé au préalable.
  • update() dans Counter additionne les compteurs, au lieu de les remplacer comme dans un dictionnaire ordinaire.
  • En cas d’égalité, most_common() conserve l’ordre dans lequel les éléments sont apparus pour la première fois.

Entrées associées

#

Pratiquer dans les leçons

#

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