Accéder au contenu principal

Ajouter à un dictionnaire Python : Comment ajouter des paires clé-valeur

Découvrez comment ajouter des paires clé-valeur dans un dictionnaire Python à l'aide de méthodes telles que la notation entre crochets, .update() pour les ajouts en masse et .setdefault() pour les insertions conditionnelles.
Actualisé 6 août 2025  · 8 min de lecture

En programmation Python, les dictionnaires sont extrêmement polyvalents, vous permettant de stocker des données sous forme de paires clé-valeur pour une gestion et un accès efficaces. Si vous débutez avec Python, il est important de comprendre comment manipuler ces dictionnaires, car cela améliorera considérablement votre gestion des données dans diverses applications. Que vous configuriez des paramètres, gériez des ensembles de données complexes ou stockiez simplement des données pour une consultation rapide, les dictionnaires sont la solution qu'il vous faut.

L'une des opérations clés que vous devrez souvent effectuer consiste à ajouter des éléments à un dictionnaire. Cet article vous guidera à travers différentes méthodes pour ajouter des éléments à un dictionnaire en Python, de la notation de base entre crochets à des techniques plus avancées telles que l'utilisation de la méthode update() et de l'opérateur de fusion. 

Si vous n'êtes pas familier avec le concept des dictionnaires en Python, nous vous recommandons de consulter également notre tutoriel sur les dictionnaires Python ou notre tutoriel sur la compréhension des dictionnaires Python, qui constituent d'excellentes ressources pour en savoir plus sur les paires clé-valeur et d'autres concepts fondamentaux des dictionnaires. De plus, notre aide-mémoire Démarrer avec Python pourrait vous être utile comme référence rapide si vous avez besoin de rafraîchir vos connaissances sur la syntaxe et les fonctions Python.

Réponse rapide : Comment ajouter un élément à un dictionnaire en Python

Si vous recherchez une solution rapide pour ajouter des éléments à un dictionnaire Python, la méthode update() est l'une des plus courantes et des plus conviviales :

# Initial dictionary with information for one person
people_info = {
    'person_1': {
        'name': 'Alice',
        'city': 'New York'
    }
}

# Updating Alice's information and adding another person
people_info.update({
    'person_1': {
        'name': 'Alice',
        'city': 'Los Angeles',  # Updated city
        'age': 30               # Added new detail
    },
    'person_2': {
        'name': 'Bob',
        'city': 'San Francisco'
    }
})

print(people_info)

# {
#     'person_1': {'name': 'Alice', 'city': 'Los Angeles', 'age': 30},
#     'person_2': {'name': 'Bob', 'city': 'San Francisco'}
# }

Dans cet exemple, la méthode update() met à jour les informations d'Alice sous la clé 'person_1', en modifiant son adresse e-mail city pour 'Los Angeles' et en ajoutant une nouvelle information age: 30. Il ajoute également une nouvelle personne, Bob, sous la clé 'person_2'.

Comprendre les dictionnaires Python

Pour commencer, nous pouvons aborder les dictionnaires Python et leur importance dans la programmation.

Qu'est-ce qu'un dictionnaire Python ?

En Python, un dictionnaire est un ensemble de paires clé-valeur. Chaque clé d'un dictionnaire est unique et correspond à une valeur, qui peut être de n'importe quel type de données (chaînes, entiers, listes ou même d'autres dictionnaires). Cette structure permet la récupération, l'ajout et la modification des données. Voici un exemple simple de dictionnaire Python :

# Example of a dictionary
person = {
    'name': 'Alice',
    'age': 25,
    'city': 'New York'
}

# Accessing a value
print(person['name'])  # Output: Alice

Dans cet exemple, 'name', 'age' et 'city' sont des clés, et 'Alice', 25 et 'New York' sont leurs valeurs correspondantes.

Structure d'un dictionnaire Python

Les dictionnaires sont des collections non ordonnées, ce qui signifie que les éléments n'ont pas d'ordre défini. Cependant, à partir de Python 3.7, les dictionnaires conservent l'ordre d'insertion, ce qui peut s'avérer utile dans diverses applications. Voici un exemple plus détaillé pour illustrer la structure :

# A more complex dictionary
employee = {
    'id': 101,
    'name': 'John Doe',
    'age': 30,
    'department': 'Engineering',
    'skills': ['Python', 'Machine Learning', 'Data Analysis'],
    'address': {
        'street': '123 Main St',
        'city': 'San Francisco',
        'state': 'CA',
        'zip': '94105'
    }
}

# Accessing nested data
print(employee['skills'][1])  # Output: Machine Learning
print(employee['address']['city'])  # Output: San Francisco

Dans cet exemple, le dictionnairedes employés contient différents types de données, notamment une liste ('skills') et un autre dictionnaire ('address'). Cela démontre comment les dictionnaires peuvent être utilisés pour stocker et organiser des structures de données complexes.

Maintenant que nous avons abordé les bases, explorons plus en détail les différentes méthodes permettant d'ajouter des éléments à un dictionnaire.

Méthodes pour ajouter des éléments à un dictionnaire en Python

L'ajout d'éléments à un dictionnaire est une tâche courante en Python, et il existe plusieurs méthodes pour le faire, chacune avec ses propres cas d'utilisation et avantages. Examinons-les un par un.

Utilisation de la notation entre crochets

La méthode la plus simple pour ajouter une paire clé-valeur à un dictionnaire consiste à utiliser la notation entre crochets. Cette méthode est simple et efficace pour ajouter des éléments individuels. Voici lasyntaxe del':

dictionary[key] = value

Voici un exemple utilisant la notation entre crochets :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add a new key-value pair
my_dict['city'] = 'New York'

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York'}

Cette méthode ajoute ou met à jour directement la paire clé-valeur dans le dictionnaire. Si la clé existe déjà, sa valeur sera mise à jour.

Lorsque vous utilisez des crochets pour ajouter une clé qui existe déjà dans le dictionnaire, la valeur associée à cette clé est mise à jour. Cela peut être considéré comme un avantage ou un inconvénient, selon vos besoins. Voici un exemple illustrant comment gérer les clés existantes :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add a new key-value pair
my_dict['city'] = 'New York'

# Update an existing key-value pair
my_dict['age'] = 30

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 30, 'city': 'New York'}

Dans cet exemple, la valeur de la clé 'age' est mise à jour de 25 à 30.

Utilisation de la méthode .update()

La méthode d'.update() permet d'ajouter plusieurs paires clé-valeur à un dictionnaire en une seule fois. Il peut accepter un autre dictionnaire ou un itérable de paires clé-valeur. Voici le ssyntaxe :

dictionary.update(other)

Voici un exemple utilisant la méthode .update() :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add new key-value pairs using update()
my_dict.update({'city': 'New York', 'email': 'alice@example.com'})

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

La méthode.update() peut également être utilisée avec un itérable de paires clé-valeur. Voici un exemple :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add new key-value pairs using update() with an iterable
my_dict.update([('city', 'New York'), ('email', 'alice@example.com')])

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

La méthode.update() est particulièrement utile lorsque vous devez mettre à jour le dictionnaire avec plusieurs nouvelles entrées simultanément. Si une clé existe déjà, sa valeur sera mise à jour.

Utilisation de la méthode .setdefault()

La méthode.setdefault() est utilisée pour ajouter une paire clé-valeur à un dictionnaire uniquement si la clé n'existe pas encore. Si la clé existe, la fonction renvoie la valeur existante. Voici le ssyntaxe :

dictionary.setdefault(key, default_value)

Voici un exemple utilisant la méthode .setdefault() :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Use setdefault to add a new key-value pair
my_dict.setdefault('city', 'New York')

# Attempt to add an existing key
my_dict.setdefault('age', 30)

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York'}

Dans cet exemple, la méthode .setdefault() ajoute la clé 'city' avec la valeur 'New York', car elle n'existait pas encore dans le dictionnaire. Lorsque vous essayez d'ajouter la clé 'age', la valeur existante 25 ne change pas , car la clé existe déjà.

Cette approche est appropriée lorsque vous devez vous assurer qu'une clé possède une valeur par défaut si elle n'existe pas. Il peut également être utilisé lorsque vous souhaitez ajouter de nouvelles paires clé-valeur sans écraser celles qui existent déjà.

Utilisation du constructeur dict()

Vous pouvez également créer un nouveau dictionnaire avec des paires clé-valeur supplémentaires à l'aide du constructeur dict(). Cette approche est utile lorsque vous souhaitez créer un nouveau dictionnaire à partir d'un dictionnaire existant. Voici le ssyntaxe :

new_dict = dict(existing_dict, key1=value1, key2=value2)

Voici un exemple utilisant le dict() constructeur :

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Create a new dictionary with additional key-value pairs
new_dict = dict(my_dict, city='New York', email='alice@example.com')

# Print the new dictionary
print(new_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

Dans cet exemple, le constructeur dict() est utilisé pour créer un nouveau dictionnaire new_dict qui inclut les paires clé-valeur d'origine de my_dict et les paires clé-valeur supplémentaires 'city': 'New York' et 'email': 'alice@example.com'.

Cette approche est utile lorsque vous souhaitez créer un nouveau dictionnaire en combinant des dictionnaires existants et des paires clé-valeur supplémentaires. Il peut également être utilisé lorsque vous devez créer un nouveau dictionnaire avec quelques modifications tout en conservant le dictionnaire d'origine inchangé.

Tableau comparatif

Voici un tableau récapitulatif des méthodes abordées dans notre tutoriel :

Méthode Cas d'utilisation Exemple
Crochet Paire clé-valeur unique dict[clé] = valeur
.update() Plusieurs paires clé-valeur dict.update({clé1 : valeur1, clé2 : valeur2})
.setdefault() Ajouter une paire clé-valeur uniquement si la clé n'existe pas dict.setdefault(key, default_value)
Constructeur dict() Créez un nouveau dictionnaire ou mettez à jour un dictionnaire existant en ajoutant des paires clé-valeur supplémentaires. new_dict = dict(existing_dict, key1=value1, key2=value2)

Techniques avancées pour ajouter des éléments à des dictionnaires en Python

Il est essentiel de comprendre les bases de la manipulation des dictionnaires, mais pour vraiment maîtriser les dictionnaires en Python, il est important d'explorer certaines techniques avancées. Ces méthodes vous permettront de mieux gérer et manipuler efficacement les dictionnaires dans des scénarios plus complexes.

Ajouter des éléments à des listes dans un dictionnaire

Souvent, les dictionnaires sont utilisés pour stocker des listes en tant que valeurs. L'ajout d'éléments à ces listes nécessite une approche légèrement différente. Voici comment procéder à l'aide d'.append():

# Initialize a dictionary with a list as a value
dictionary_w_list = {'fruits': ['apple', 'banana']}

# Append an element to the list within the dictionary
dictionary_w_list['fruits'].append('cherry')

# Print the updated dictionary
print(dictionary_w_list)
# Output: {'fruits': ['apple', 'banana', 'cherry']}

Dans cet exemple, nous commençons par dictionary_w_list où la clé 'fruits' correspond à une liste ['apple', 'banana']. En utilisant la méthode d' .append(), nous ajoutons 'cherry' à la liste. Cette technique est particulièrement utile pour gérer des collections d'éléments au sein d'un même dictionnaire.

Combiner des dictionnaires à l'aide de l'opérateur de fusion

Python 3.9 a introduit l'opérateur de fusion (|) pour combiner des dictionnaires. Cet opérateur vous permet de fusionner deux dictionnaires en un seul sans effort :

# Initialize two dictionaries
first_dictionary = {'name': 'Alice', 'age': 25}
second_dictionary = {'city': 'New York', 'email': 'alice@example.com'}

# Merge the dictionaries using the merge operator
merged_dictionary = first_dictionary | second_dictionary

# Print the merged dictionary
print(merged_dictionary)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

Dans cet exemple, first_dictionary et second_dictionary sont fusionnés dans un nouveau dictionnaire merged_dictionary. L'opérateur de fusion (|) combine les paires clé-valeur des deux dictionnaires, ce qui en fait une méthode rapide et pratique pour fusionner des dictionnaires.

Utilisation de l'opérateur de mise à jour

Pour les mises à jour sur place, Python 3.9 a également introduit l'opérateur de mise à jour |=. Cet opérateur vous permet de mettre à jour le dictionnaire d'origine avec les paires clé-valeur d'un autre dictionnaire.

# Initialize two dictionaries
first_dictionary = {'name': 'Alice', 'age': 25}
second_dictionary = {'city': 'New York', 'email': 'alice@example.com'}

# Update dict1 in-place using the update |= operator
first_dictionary |= second_dictionary

# Print the updated dictionary
print(first_dictionary)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

Ici, l'opérateurde mise à jour |= met à jour first_dictionary avec le contenu de second_dictionary. Cela signifie que le fichier first_dictionary est directement modifié. Cette méthode est particulièrement utile lorsque vous devez mettre à jour un dictionnaire existant sans en créer un nouveau.

Conclusion

Dans cet article, nous avons découvert les dictionnaires Python et les méthodes permettant d'ajouter des paires clé-valeur. Nous avons commencé par des techniques fondamentales telles que l'utilisation de la notation entre crochets et la méthode .update(), qui est essentielle pour effectuer des mises à jour rapides et simples. Nous sommes ensuite passés à des techniques plus avancées, notamment l'ajout à des listes dans des dictionnaires, la fusion de dictionnaires à l'aide de l'opérateur merge (|) et la mise à jour sur place à l'aide de l'opérateur update |=. Ces méthodes constituent des outils puissants pour gérer des structures de données complexes et effectuer des opérations efficaces.

Voici quelques-unes de nos ressources que vous pouvez consulter pour approfondir vos connaissances en Python. Nous vous recommandons de commencer par le cours Introduction à Python, qui constitue un excellent point de départ car il fournit des bases solides sur les fondamentaux de Python, en mettant l'accent sur les applications en science des données. Le cursus de programmation Python propose également un programme complet qui vous permettra de passer du niveau débutant à celui de programmeur expérimenté.

Notre cursus Développeur Python est également conçu pour ceux qui souhaitent se familiariser avec la programmation Python. Il offre une couverture complète des concepts et techniques de programmation plus complexes.


Samuel Shaibu's photo
Author
Samuel Shaibu
LinkedIn

Professionnel expérimenté des données et écrivain passionné par l'autonomisation des experts en herbe dans le domaine des données.

Questions fréquemment posées

Comment ajouter une nouvelle paire clé-valeur à un dictionnaire Python ?

Vous pouvez ajouter une nouvelle paire clé-valeur à un dictionnaire Python en utilisant la notation entre crochets, comme suit : dictionary[key] = value. Cette méthode met à jour le dictionnaire en place.

Quelle est la méthode .update() dans les dictionnaires Python et comment est-elle utilisée ?

La méthode « .update() » est utilisée pour ajouter plusieurs paires clé-valeur à un dictionnaire. Il peut accepter un autre dictionnaire ou un itérable de paires clé-valeur, mettant à jour le dictionnaire existant.

Quelle est la différence entre la méthode .update() et l'opérateur de fusion (|) pour combiner des dictionnaires en Python ?

La méthode d'.update() ion modifie le dictionnaire existant en place en ajoutant des paires clé-valeur provenant d'un autre dictionnaire, ce qui peut entraîner l'écrasement des clés existantes. L'opérateur merge crée un nouveau dictionnaire contenant les éléments des deux dictionnaires, sans modifier les dictionnaires d'origine.

Sujets

Apprenez Python avec DataCamp

Cours

Introduction à Python

4 h
6.6M
Apprenez les bases de l’analyse de données avec Python en quatre heures et explorez ses principaux packages.
Afficher les détailsRight Arrow
Commencer le cours
Voir plusRight Arrow
Apparenté

Didacticiel

Tutoriel sur les méthodes .append() et .extend() de Python

Apprenez à utiliser les méthodes .append() et .extend() pour ajouter des éléments à une liste.
DataCamp Team's photo

DataCamp Team

Didacticiel

Méthode index() de Python expliquée à l'aide d'exemples

Découvrez comment utiliser la fonction index() de Python pour trouver la position d'éléments dans des listes.
Sejal Jaiswal's photo

Sejal Jaiswal

Didacticiel

Comment tronquer une chaîne en Python : Trois méthodes distinctes

Apprenez les principes fondamentaux de la suppression des caractères de début et de fin d'une chaîne en Python.
Adel Nehme's photo

Adel Nehme

Didacticiel

Python Switch Case Statement : Guide du débutant

Découvrez le match-case de Python : un guide sur sa syntaxe, ses applications en data science, ML, et une analyse comparative avec le switch-case traditionnel.
Matt Crabtree's photo

Matt Crabtree

Didacticiel

Comment arrondir à 2 décimales en Python

Découvrez comment arrondir un nombre à deux décimales dans Python pour une plus grande précision à l'aide de techniques telles que round(), format() et les techniques de formatage de chaînes.
Allan Ouko's photo

Allan Ouko

Didacticiel

if…elif…else dans le tutoriel Python

Découvrez comment créer des instructions if…elif…else en Python.
DataCamp Team's photo

DataCamp Team

Voir plusVoir plus