Participer au site avec un Tip
Rechercher
 

Améliorations / Corrections

Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.

Emplacement :

Description des améliorations :

Classe « list » Python 3.12.1

Méthode builtins.list.insert

Signature de la méthode insert

 def insert(self, position, value) -> None

Description

Insère une nouvelle valeur dans la liste courante, à la position spécifiée en paramètre. Le code l.insert(0, value) insère la valeur en tête de liste. Le code l.insert(len(l), value) insère la valeur à la fin de la liste : c'est équivalent à un appel à l.append(value). Les listes Python n'étant pas typées, il n'y a aucune limitation sur la nature de la valeur ajoutée.

la méthode append est « thread-safe ». Si plusieurs threads travaillent simultanément sur la même liste, chaque insertion de valeur sera garantie.

help(list.insert)

Insert object before index.

Paramètres

ParamètreDescription
 self : list 
La liste courante. Rappel : self est implicitement passée lors de l'appel de la méthode.
 index : int 
La position dans la liste à laquelle ajouter la nouvelle valeur. Si la position spécifiée est supérieure à la taille de la list, la nouvelle valeur sera ajoutée à la fin de la liste.
 value : object 
la nouvelle valeur à ajouter à la liste.

Valeur de retour

Cette méthode ne renvoie aucune valeur.

Exemple(s) de code

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
#!/usr/bin/python3

# Une liste initiale
data = [10, 20, 30]    
print(data) 

# On y ajout des valeurs au milieu
data.insert(1, 15)
data.insert(3, 25)
print(data) 

# On test une position supérieure à la taille de la liste -> insertion à la fin
data.insert(100, 50)    
print(data)
Exemple d'insertion de valeurs dans une liste d'entier

Et voici un exemple d'exécution de ce programme :

[10, 20, 30]
[10, 15, 20, 25, 30]
[10, 15, 20, 25, 30, 50]

Voir aussi

Classe dict
Classe set

Méthode list.append
Méthode list.extend