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 bytes ( ) 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 ver 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  bytes ( ).partition ( ) retourne un tuple ( ) de trois éléments, où l'élément à : 

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

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

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

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

EXEMPLES.

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

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

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

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

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

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