DESCRIPTION.

Retourne l'index du premier item ayant une certaine valeur rencontré dans le tuple, ou dans la plage d'items précisés.

SYNTAXE.

Position = TPL_Designation.index ( valeur , debut , fin )

Position = ⇨ variable qui recevra l'index de l'items [ optionnel ]

TPL_Designation ⇨ nom du tuple [ OBLIGATOIRE ]

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

valeur ⇨ valeur à rechercher [ OBLIGATOIRE ]

debut ⇨ index á partir duquel commence la recherche [ optionnel ]

fin ⇨ index á partir duquel la recherche s'arrête [ optionnel ]

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 recherché.

debut et fin sont des int ( ) indiquant la tranche du tuple ( ) qui faudra examiner pour la requête. Si debut et fin sont absents, la recherche se fera sur tous les élément du tuplet ( ). L'item à l'index debut est inclus dans la recherche, alors que l'item à l'index fin en est exclus. Si fin est omis, valeur sera recherché de debut à la fin du tuple ( ). debut peut être négatif.

TPL_Designation doit être un tuple ( ) existante et valide, même s'il ne possède aucun item (tuple ( ) vide).

Si le tuple ( ), ou la tranche d'items, contient plusieurs éléments avec la valeur demandée, c'est l'index du premier élément qui sera retourné. Si aucun item n'a la valeur recherchée Python lèvera une exception. 

Rappel : Le premier item d'une collection (list ( ), tuple ( ), ... ) se trouve à l'index 0.

EXEMPLES.

TPL_Mississippi = ( "m" , "i" , "s" , "s" , "i" , "s" , "s" , "i" , "p" , "p" , "i" )

print ( TPL_Mississippi.index ( "s" ) ) retourne 2

print ( TPL_Mississippi.index ( "s" , 4 ) ) retourne 5

print ( TPL_Mississippi.index ( "i" , -4 ) ) retourne 7

print ( TPL_Mississippi.index ( "s" , 3 , 6 ) ) retourne 3

print ( TPL_Mississippi.index ( "a" ) ) retourne ValueError: 'a' is not in list

print ( TPL_Mississippi.index ( "p" , 2 , 5 ) ) retourne ValueError: 'p' is not in list

print ( TPL_Mississippi.index ( "p" ) ) retourne 8

print ( TPL_Mississippi.index ( "p" , 2 , 8 ) ) retourne ValueError: 'p' is not in list

La lettre p se trouve â l'index 8, mais dans la tranche 2 à 8, l'item à l'index 8 est exclu de la recherche.

Retrouver tous les index des items avec une certaine valeur.

TPL_Mississippi = ( "m" , "i" , "s" , "s" , "i" , "s" , "s" , "i" , "p" , "p" , "i" )

for kelement in enumerate ( TPL_Mississippi ) :

if kelement [ 1 ] == "s" : print ( kelement [ 0 ] , end = " " )

retourne 2 3 5 6

ou

TPL_Mississippi = ( "m" , "i" , "s" , "s" , "i" , "s" , "s" , "i" , "p" , "p" , "i" )

for kindex in range ( len ( TPL_Mississippi ) ) :

if TPL_Mississippi [ kindex ] == "s" : print ( kindex , end = " " )

retourne 2 3 5 6