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

La valeur retournée par la méthode bytes ( ).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, bytes ( ).find ( ) retourne -1, contrairement à la méthode bytes ( ).index ( ) qui, elle, lèvera une exception.

EXEMPLES.

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

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

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

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

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

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

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

BYT_Titre = b"Mon Python a moi."

BYT_Langage = b"Python"

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

print ( BYT_Titre.find ( BYT_Langage ) ) retourne 4