Classe « str » Python 3.11.3

Méthode builtins.str.index

Signature de la méthode index

 def index(self, substring, start=0, end=None) -> int

Description

Renvoie la position dans la chaîne courante de la première occurrence de la chaîne passée en paramètre. La recherche s'exécute, par défaut, dans l'intégralité de la chaîne courante, mais il est aussi possible de réaliser cette recherche dans une partie (une slice) de la chaîne courante. Ainsi, l'appel "a sample string".index("s", 4, 12) est équivalent à "a sample string"[4:12].index("s") (slice notation).

si vous cherchez juste à tester la présence d'une sous-chaîne, veuillez privilégier l'utilisation de l'opérateur in, comme le montre l'exemple suivant.

>>> s = "Le langage Python est génial"
>>> "Python" in s
True
>>>

cette méthode est très proche de la méthode str.find. La différence réside dans le fait que index déclenche une exception si la chaîne recherchée n'est pas présente, alors que la méthode find renvoie la valeur -1 dans cette situation.

help(str.index)

S.index(sub[, start[, end]]) -> int

Return the lowest index in S where substring sub is found,
such that sub is contained within S[start:end].  Optional
arguments start and end are interpreted as in slice notation.

Raises ValueError when the substring is not found.

Paramètres

Paramètre	Description
self : str	La chaîne de caractères courante. Rappel : `self` est implicitement passée lors de l'appel de la méthode.
substring : str	La sous-chaîne à rechercher.
start : int = 0	L'indice du premier caractère à partir duquel réaliser la recherche. Rappel : les indices sont basés à partir de 0.
end : int = None	Indice du caractère à partir duquel arrêter la recherche. La valeur `None` indiquant qu'on recherche la sous-chaîne jusqu'à la fin de la chaîne courante.

Valeur de retour

La valeur de retour est de type int.

Si la chaîne de caractères cherchée est présente dans la chaîne courante, la position de sa première occurrence vous sera retournée (indice basé à partir de 0). Dans le cas contraire, une exception de type ValueError sera déclenchée.

Exceptions

```
 TypeError :
```
Une exception de ce type sera déclenchée si l'un des paramètres n'est pas du type attendu.
```
 ValueError :
```
Cette exception sera levée si la chaîne de caractères recherchée n'est pas trouvée.

Exemple(s) de code

Exemple d'utilisation de la méthode index.
1 2 3 4 5 6 7 8 9 10 11 12 13	#!/usr/bin/python3 full_string = "Le langage Python est génial" searched_string = "Python" try: pos = full_string.index(searched_string) print("Avant :", full_string[0:pos]) print("Recherche :", full_string[pos:pos + len(searched_string)]) print("Après :", full_string[pos + len(searched_string):]) except ValueError: print("La chaîne recherchée n'est pas présente.")

#!/usr/bin/python3

full_string = "Le langage Python est génial"
searched_string = "Python"

try:
    pos = full_string.index(searched_string)

    print("Avant :", full_string[0:pos])
    print("Recherche :", full_string[pos:pos + len(searched_string)])
    print("Après :", full_string[pos + len(searched_string):])
except ValueError:
    print("La chaîne recherchée n'est pas présente.")

Exemple d'utilisation de la méthode index.

Et voici les résultats produits par cet exemple.

$> python3 sample.py
Avant : Le langage 
Recherche : Python
Après :  est génial
$>

Voir aussi

Classe str
Méthode str.count
Méthode str.endswith
Méthode str.find
Méthode str.rfind
Méthode str.rindex
Méthode str.startswith

Le tutoriel Python complet (Text+Vidéos)

Le tutoriel Python en vidéos

Evaluez vos compétences en Python

Améliorations / Corrections