dict.
Ajoute à un dictionnaire les paires d’un autre dictionnaire ou d’arguments, en écrasant les clés existantes.
- Renvoie
None(le dictionnaire change sur place).- Modifie l’original
- Oui
Exemple
#profile = {"name": "Léa", "level": 3, "theme": "light"}
profile.update({"level": 4, "streak": 12})
print(profile)
profile.update(theme="dark")
print(profile)Définition et utilisation
#La méthode update() ajoute au dictionnaire toutes les paires d’un dictionnaire donné, d’une liste de paires ou d’arguments nommés. Si une clé existe déjà, sa valeur est remplacée par la nouvelle. Le dictionnaire change sur place, et la méthode renvoie None.
Les usages typiques sont la superposition des réglages d’un utilisateur sur des valeurs par défaut, et la modification de plusieurs champs d’un enregistrement à la fois plutôt qu’un par un.
Depuis Python 3.9, des opérateurs sont aussi disponibles : a | b crée un nouveau dictionnaire fusionné sans changer les originaux, et a |= b fonctionne comme update(). En cas de conflit de clés, c’est toujours la valeur de droite qui l’emporte.
Syntaxe
#dictionnaire.update(other)
dictionnaire.update(key=value, …)Paramètres
#other
un dictionnaire ou une collection de paires, optionnel
La source des nouvelles paires clé-valeur.**kwargs
optionnel
Paires données comme arguments nommés, par ex.level=4.
Plus d’exemples
#defaults = {"theme": "dark", "lang": "fr", "sound": True}
user = {"lang": "en", "sound": False}
settings = defaults | user
print(settings)
print(defaults)stats = {"exp": 100}
result = stats.update(exp=150)
print(result)
print(stats)Bonnes pratiques
#- N’assignez pas le résultat de la méthode :
d = d.update(...)transforme le dictionnaire enNone. Appelezupdate()comme une instruction à part. - Quand l’original doit rester inchangé, créez un nouveau dictionnaire avec
a | bou{**a, **b}. - La fusion est superficielle : un dictionnaire imbriqué à droite remplace entièrement celui de gauche au lieu de s’y fondre.
Entrées associées
#- dict.setdefault()Renvoie la valeur d’une clé, et commence par enregistrer une valeur par défaut dans le dictionnaire quand la clé est absente.
- dict.pop()Supprime une clé d’un dictionnaire et renvoie sa valeur, avec éventuellement une valeur de repli.
- dict()Crée un dictionnaire à partir de paires clé-valeur ou d’arguments nommés.
- Compréhension de dictionnaireUne façon concise de construire un nouveau dictionnaire en transformant ou en filtrant une autre collection.
- list.extend()Ajoute à la fin d’une liste tous les éléments d’une autre collection.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.