DESCRIPTION.

Ajoute un item (élément) à la fin de la liste. 

SYNTAXE.

LST_Designation.append ( valeur )

LST_Designation ⇨ nom de la liste [ OBLIGATOIRE ]

.append ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

valeur ⇨ valeur à affecter à l'item [ OBLIGATOIRE ]

REMARQUES.

valeur peut être n'importe quel type d'objet valide dans Python. Si valeur est un objet composite, tel que : list ( ), tuple ( ), dict ( ), ..., c'est bien cet objet, avec tous ces items, qui sera inséré en fin de liste et non les items de cet objet.

La méthode list ( ).append ( ) ajoute un seul et unique item à la fin de la liste.

LST_Designation doit être une liste existante et valide, même si elle ne possède aucun item (liste vide).

LST_Designation.append ( valeur ) équivaut à LST_Designation.extend ( valeur ) et à LST_Designation +=  [ valeur ]

EXEMPLES.

LST_Carres = [ 1 , 4 , 9 , 16 , 25 ]

print ( LST_Carres ) retourne [ 1, 4, 9, 16, 25 ]

LST_Carres.append ( 36 )

LST_Carres.append ( 49 )

print ( LST_Carres ) retourne [ 1, 4, 9, 16, 25, 36, 49 ]

la liste comprends 2 items de plus, les valeurs sont ajoutées dans l'ordre des ajouts.

print ( LST_Carres [ -1 ] ) retourne 49

LST_Carres.append ( ) retourne TypeError: append() takes exactly one argument (0 given)

la méthode .append ( ) d'un objet list ( ) doit recevoir obligatoirement un argument.

LST_Carres.append ( 64 , 81 ) retourne TypeError: append() takes exactly one argument (2 given)

la méthode .append ( ) d'un objet list ( ) doit recevoir obligatoirement un seul argument.

LST_Carres.append ( [ 64 , 81 ] ) 

print ( LST_Carres ) retourne [1, 4, 9, 16, 25, [64, 81]]

les valeurs 64 et 81 ont bien été ajoutés en fin de liste, mais comme une liste de 2 items, et non comme des items distincts.

print ( LST_Carres [ -1 ] ) retourne [64, 81]

print ( type ( LST_Carres [ -1 ] ) ) retourne <class 'list'>