DESCRIPTION.

Fractionne un tableau d'octets de part et d'autre d'un séparateur et retourne un tuple ( ) contenant les deux fractions du tableau d'octets (index 0 et 2) et le séparateur (index 1).

SYNTAXE.

TPL_Parties = tableau.partition ( separateur )

TPL_Parties = ⇨ variable qui recevra la valeur [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

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

separateur ⇨ tableau d'octets de démarcation [ OBLIGATOIRE ]

REMARQUES.

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

separateur doit être un tableau d'octets de type bytes ( ) ou bytearray ( ). 

La recherche de separateur débute au premier caractère de tableau et progresse vers la fin, et s’arrête dès que separateur est trouvé. Si d'autres occurrences de separateur se trouvent dans tableau, elles seront ignorées.

La méthode  bytearray ( ).partition ( ) retourne un tuple ( ) de trois éléments, où l'élément à : 

- l'index 0 est un bytearray ( ) allant du premier octet de tableau à l'octet avant separateur ;

- l'index 1, est un bytearray ( ) reprenant separateur ;

- l'index 2 est un bytearray ( ) allant de premier octet après separateur au dernier octet de tableau.

Si separateur n'est pas trouvé dans tableau bytearray ( ).partition ( ) retournera tableau et deux bytearray ( ) vides.

EXEMPLES.

TPL_Titre = bytearray ( "Mon Python à moi." , "utf-8" ).partition ( b"Python" )

print ( TPL_Titre ) retourne (bytearray(b'Mon '), bytearray(b'Python'), bytearray(b' \xc3\xa0 moi.'))

print ( type ( TPL_Titre ) ) retourne <class 'tuple'>

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

print ( BYA_Titre.partition ( b"on" ) ) retourne (bytearray(b'M'), bytearray(b'on'), bytearray(b' Python \xc3\xa0 moi.'))

print ( BYA_Titre.partition ( b"Nerd" ) ) retourne (bytearray(b'Mon Python \xc3\xa0 moi.'), bytearray(b''), bytearray(b''))