DESCRIPTION.

Ajoute plusieurs items (éléments) à la fin de la liste. 

SYNTAXE.

LST_Designation.extend ( [ valeura , ... , valeurn ] )

LST_Designation ⇨ nom de la liste liste [ OBLIGATOIRE ]

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

[ valeura , ... , valeurn ] ⇨ liste des valeurs à ajouter [ OBLIGATOIRE ]

REMARQUES.

[ valeura , ... , valeurn ] peut être n'importe quel type composite, tel que : list ( ), tuple ( ), set ( ), ..., sinon Python lèvera une exception.

LST_Designation.extend ( [ a , ... , n ] ) équivaut à LST_Designation +=  [ a , ... , n ].

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

EXEMPLES.

LST_Carres = [ 1 , 4 , 9 ]

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

LST_Carres.extend ( [ 16 , 25 , 36 ] )

LST_Carres.extend ( ( 49 , 68 ) )

LST_Carres.extend ( { 81 , 100 } )

LST_Carres.extend ( [ knombre ** 2 for knombre in range ( 11 , 16 ) ] )

print ( LST_Carres ) retourne [1, 4, 9, 16, 25, 36, 49, 68, 81, 100, 121, 144, 169, 196, 225]

.extend ( ) accepte comme argument diverses objets collections itérables.

LST_Carres.extend ( 256, 289 ) retourne TypeError: extend() takes exactly one argument (2 given)

Les valeurs à ajouter doivent se trouver dans un objet collection itérable. Il faut fournir obligatoirement 1 argument unique à .extend ( ).

LST_Carres.extend ( 256 ) retourne TypeError: 'int' object is not iterable

L'argument unique passé à .extend ( ) doit être un objet collection itérable avec un nombre d'item quelconque.

LST_Carres.extend ( [ ] )

print ( LST_Carres ) retourne [1, 4, 9, 16, 25, 36, 49, 68, 81, 100, 121, 144, 169, 196, 225]

Un objet collection itérables vide ne lève pas d'erreur.