set.add()

Ajoute un élément à un ensemble. Si l’élément y est déjà, l’ensemble ne change pas.

Renvoie
None (l’ensemble change sur place).
Modifie l’original
Oui
Sur cette page

Exemple

#
Python
visited = {"leçon_1", "leçon_2"}

visited.add("leçon_3")
visited.add("leçon_1")

print(len(visited))
print(sorted(visited))
Résultatrésultat enregistré, vous pouvez le vérifier
3
['leçon_1', 'leçon_2', 'leçon_3']

Définition et utilisation

#

La méthode add(élément) insère un seul élément dans un ensemble. Un ensemble ne stocke que des valeurs uniques, donc ajouter un élément déjà présent ne change rien et ne lève pas d’erreur.

Les éléments d’un ensemble doivent être hashables, c’est-à-dire immuables en pratique : nombres, chaînes, tuples. Essayer d’ajouter une liste ou un dictionnaire lève une TypeError. Ajoutez plusieurs éléments à la fois avec la méthode update().

La méthode change l’ensemble sur place et renvoie None. Les ensembles n’ont pas d’ordre, donc un nouvel élément n’atterrit pas « à la fin » comme dans une liste. Pour l’affichage, il est pratique de trier l’ensemble avec la fonction sorted().

Syntaxe

#
Syntaxe
ensemble.add(element)

Paramètres

#
  • element

    une valeur hashable

    L’élément à ajouter.

Plus d’exemples

#
Détecter les répétitions
Python
logins = ["léa", "lucas", "léa", "emma", "lucas"]
seen = set()
duplicates = set()

for login in logins:
    if login in seen:
        duplicates.add(login)
    seen.add(login)

print(sorted(duplicates))
Résultatrésultat enregistré, vous pouvez le vérifier
['lucas', 'léa']
Toutes les valeurs ne peuvent pas être ajoutées
Python
tags = set()
tags.add(("python", 3))
print(tags)

try:
    tags.add(["python", 3])
except TypeError:
    print("Une liste ne peut pas être un élément d’un ensemble")
Résultatrésultat enregistré, vous pouvez le vérifier
{('python', 3)}
Une liste ne peut pas être un élément d’un ensemble

Bonnes pratiques

#
  • Un ensemble comme seen est excellent pour se souvenir de ce qu’on a déjà rencontré. Vérifier x in seen est rapide quel que soit le nombre d’éléments.
  • Créez un ensemble vide uniquement avec set(), car {} signifie un dictionnaire vide.

Entrées associées

#

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