DESCRIPTION.

Retourne la première position trouvée d'une suite d'octets dans, tout ou partie, d'un tableau d'octets.

SYNTAXE.

Position = tableau.index ( modele , debut , fin )

Position = ⇨ variable qui recevra la valeur [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

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

modele ⇨ valeur à rechercher [ OBLIGATOIRE ]

debut ⇨ index où commence la recherche [ optionnel ]

fin ⇨ index où la recherche s'arrête [ optionnel ]

REMARQUES.

tableau doit être un objet de type bytes ( ) valide.

modele doit être un bytes ( ), un bytearray ( ) ou un int ( ) entre 0 et 255 correspondant au caractère ASCII recherché, et peut être un tuple ( ) contenant diverses combinaisons de tableaux d'octets à tester. 

debut et fin sont des int ( ) indiquant la tranche de tableau qui faudra examiner pour la requête. Si  debut et fin sont absents, la recherche se fera sur tous les élément de tableau. Si fin est omis, modele sera recherché :

- de debut à la fin de tableau si debut est positif ;

- et de debut au premier élément de tableau si debut est négatif.

La valeur retournée par la méthode bytes ( ).index ( ) correspond à l'index, dans le tableau d'octets tableau, du premier octet de modele recherché. Si modele n'est pas trouvé dans tableau, ou dans la sous-chaine indiquée, bytes ( ).index ( ) lèvera une exception, contrairement à la méthode bytes ( ).find ( ) qui retourne -1 dans ce cas.

EXEMPLES.

BYT_Titre = bytes ( "Mon Python à moi." , "utf-8" )

print ( BYT_Titre.index ( b"on" ) ) retourne 1

print ( BYT_Titre.index ( b"On" ) ) retourne ValueError: subsection not found

print ( BYT_Titre.index ( b"ON" ) ) retourne ValueError: subsection not found

print ( BYT_Titre.index ( b"on" , 4 ) ) retourne 8

print ( BYT_Titre.index ( b"on" , -10 ) ) retourne 8

print ( BYT_Titre.index ( b"on" , 4 , 9 ) ) retourne ValueError: subsection not found

BYT_Language = b"Python"

print ( BYT_Titre.index ( b"Python" ) ) retourne 4

print ( BYT_Titre.index ( BYT_Language ) ) retourne 4