list.index()

Renvoie l’indice de la première occurrence d’une valeur dans une liste.

Renvoie
L’indice de la première occurrence.
Modifie l’original
Non
Sur cette page

Exemple

#
Python
ranking = ["Léa", "Emma", "Lucas", "Emma"]

print(ranking.index("Emma"))
print(ranking.index("Emma", 2))

name = "Noé"
print(ranking.index(name) if name in ranking else "absent du classement")
Résultatrésultat enregistré, vous pouvez le vérifier
1
3
absent du classement

Définition et utilisation

#

La méthode index(x) renvoie la position du premier élément égal à x. Les arguments optionnels start et end limitent la partie de la liste à parcourir.

Si la valeur est absente, une ValueError est levée, au lieu de renvoyer -1 comme le fait la méthode find() des chaînes. C’est pourquoi il vaut la peine de vérifier sa présence avec l’opérateur in avant l’appel.

La recherche parcourt les éléments un par un, donc elle peut être lente sur de très grandes listes. Pour des recherches fréquentes, un dictionnaire est un meilleur choix.

Syntaxe

#
Syntaxe
liste.index(value, start=0, end=len(liste))

Paramètres

#
  • value

    n’importe quelle valeur

    La valeur recherchée.
  • start, end

    int, optionnel

    La plage de recherche.

Bonnes pratiques

#
  • Vérifiez avec in avant index(), pour éviter l’exception.
  • Quand vous avez besoin des indices de toutes les occurrences : [i for i, x in enumerate(items) if x == value].

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.