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.find ( modele , debut , fin )

Position = ⇨ variable qui recevra la valeur [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

.find ( ) ⇨ 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 bytearray ( ) 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.

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

EXEMPLES.

BYA_Titre = bytearray ( "Mon Python à moi." , "utf-8" )

print ( BYA_Titre.find ( b"on" ) ) retourne 1

print ( BYA_Titre.find ( b"On" ) ) retourne -1

print ( BYA_Titre.find ( b"ON" ) ) retourne -1

print ( BYA_Titre.find ( b"on" , 4 ) ) retourne 8

print ( BYA_Titre.find ( b"on" , -10 ) ) retourne 8

print ( BYA_Titre.find ( b"on" , 4 , 9 ) ) retourne -1

BYA_Titre = bytearray ( "Mon Python à moi." , "utf-8" )

BYT_Langage = b"Python"

print ( BYA_Titre.find ( b"Python" ) ) retourne 4

print ( BYA_Titre.find ( BYT_Langage ) ) retourne 4