DESCRIPTION.

Retourne l'ensemble des tuple ( ) composés de l'index et la valeur, de tous les éléments contenus dans un objet-collection.

SYNTAXE.

enumerate ( iterable , decalage )

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

iterable ⇨ objet itérable [ OBLIGATOIRE ]

decalage ⇨ valeur à ajouter à l'index [ optionnel ]

REMARQUE.

iterable doit être un objet collection valide tel que : list ( ), tuple ( ), str ( ), bytes ( ) ...

decalage est un int ( ) donc la valeur sera ajouté à l'index de l'élément associé. decalage peut être négatif.

enumerate ( ) est particulièrement utile pour :

- créer des list ( ) ou dict ( ) reflétant un classement ordonné ;

- effectuer le traitement des éléments de iterable en fonction de leur index.

La méthode enumerate ( ) retourne un objet de type enumerate.

EXEMPLE.

LST_Jours = [ "lundi" , "Mardi" , "Mercredi" , "Jeudi" , "Vendredi" , "Samedi" , "Dimanche" ]

print ( enumerate ( LST_Jours ) ) retourne <enumerate object at 0xb4ef9a30>

LST_Semaine =  list ( enumerate ( LST_Jours ) )

print ( LST_Semaine ) retourne [(0, 'lundi'), (1, 'Mardi'), (2, 'Mercredi'), (3, 'Jeudi'), (4, 'Vendredi'), (5, 'Samedi'), (6, 'Dimanche')]

DCT_Semaine =  dict ( enumerate ( LST_Jours ) )

print ( DCT_Semaine ) retourne {0: 'lundi', 1: 'Mardi ', 2: 'Mercredi', 3: 'Jeudi', 4: 'Vendredi', 5: 'Samedi', 6: 'Dimanche'}

LST_Semaine =  list ( enumerate ( LST_Jours , 4 ) )

print ( LST_Semaine ) retourne [(4, 'lundi'), (5, 'Mardi'), (6, 'Mercredi'), (7, 'Jeudi'), (8, 'Vendredi'), (9, 'Samedi'), (10, 'Dimanche')]

LST_Jours = [ "lundi" , "Mardi" , "Mercredi" , "Jeudi" , "Vendredi" , "Samedi" , "Dimanche" ]

for kindex , kvaleur in enumerate ( LST_Jours , 1 ) :

print ( f"Le jour { kindex } de la semaine est le { kvaleur }." ) 

retourne

Le jour 1 de la semaine est le lundi.

Le jour 2 de la semaine est le Mardi.

Le jour 3 de la semaine est le Mercredi.

Le jour 4 de la semaine est le Jeudi.

Le jour 5 de la semaine est le Vendredi.

Le jour 6 de la semaine est le Samedi.

Le jour 7 de la semaine est le Dimanche.

remplace avantageusement :

for kindex in range ( len ( LST_Jours ) ) :

    print ( f"Le jour { kindex + 1 } de la semaine est le { LST_Jours [ kindex ] }." ) 

Dans un str ( ), ce sont les caractères qui sont retournés.

TPL_Lettres = tuple ( enumerate ( "Mon Python" , -10 ) ) 

print ( TPL_Lettres ) retourne ((-10, 'M'), (-9, 'o'), (-8, 'n'), (-7, ' '), (-6, 'P'), (-5, 'y'), (-4, 't'), (-3, 'h'), (-2, 'o'), (-1, 'n'))

Dans un dict ( ), ce sont les clés qui sont retournées (est non le couple clé-valeur).

DCT_Jours = { "Lun":"lundi" , "Mar":"Mardi" , "Mer":"Mercredi" , "Jeu":"Jeudi" , "Ven":"Vendredi" , "Sam":"Samedi" , "DIM":"Dimanche" }

for kindex , kvaleur in enumerate ( DCT_Jours , 1 ) :

print ( f"Le jour { kindex } de la semaine est le { kvaleur }." ) 

retourne

Le jour 1 de la semaine est le Lun.

Le jour 2 de la semaine est le Mar.

Le jour 3 de la semaine est le Mer.

Le jour 4 de la semaine est le Jeu.

Le jour 5 de la semaine est le Ven.

Le jour 6 de la semaine est le Sam.

Le jour 7 de la semaine est le DIM.