DESCRIPTION.

Retourne la liste de toutes les divisions, ou une certaine quantité, du tableau d'octets parent,  en utilisant un tableau d'octets modèle comme séparateur.

SYNTAXE.

LST_Mots = tableau.split ( separateur , quota )

LST_Mots = ⇨ variable qui recevra la liste [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

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

separateur ⇨ tableau d'octets modèle de découpe [ optionnel ]

quota ⇨ nombre de divisions maximum [ optionnel ]

REMARQUES.

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

separateur doit être du type bytes ( ) ou bytearray ( ) et vaut b" " par défaut. Aucun separateur n'est reprit dans la list ( ) retournée, et si separateur est omis, les caractères d'espacement en début et de fin de la tableau sont abandonnés dans la list ( ) retournée. Si plusieurs separateur se suivent dans tableau, comme des octets doubles (b"ff", b"mm", b"oo", ... par exemple), b"" sera retourné à cet emplacement dans la list ( ).

quota doit être un int ( ). Si quota est précisé, seules les premières quota tableaux d'octets separateur trouvés seront retournés dans la list ( ). Les octets restant de tableau seront placés dans le dernier élément de la list ( ) même s'ils comportent la suite separateur.

La recherche de separateur débute au premier caractère de tableau et avance dans la chaine des octets.

Les éléments de la list ( ) retournée la méthode bytearray ( ).split ( ) sont dans le même ordre que leur présence dans tableau, même si quota est présent.

EXEMPLE.

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

print ( BYA_Titre.split ( ) ) retourne [bytearray(b'Mon'), bytearray(b'Python'), bytearray(b'\xc3\xa0'), bytearray(b'moi.')]

print ( type ( BYA_Titre.split ( ) ) ) retourne <class 'list'>

print ( BYA_Titre.split ( b"o" ) ) retourne [bytearray(b'M'), bytearray(b'n Pyth'), bytearray(b'n \xc3\xa0 m'), bytearray(b'i.')]

print ( BYA_Titre.split ( b"O" ) ) retourne [bytearray(b'Mon Python \xc3\xa0 moi.')] 

print ( BYA_Titre.split ( b"on" ) ) retourne [bytearray(b'M'), bytearray(b' Pyth'), bytearray(b' \xc3\xa0 moi.')]

print ( BYA_Titre.split ( b"o" , 2 ) ) retourne [bytearray(b'M'), bytearray(b'n Pyth'), bytearray(b'n \xc3\xa0 moi.')]

BYA_Introduction = bytearray ( "Python est un langage de programmation puissant et facile à apprendre." , "utf-8" )

LST_Mots = BYA_Introduction.split ( )

print ( LST_Mots ) retourne [bytearray(b'Python'), bytearray(b'est'), bytearray(b'un'), bytearray(b'langage'), bytearray(b'de'), bytearray(b'programmation'), bytearray(b'puissant'), bytearray(b'et'), bytearray(b'facile'), bytearray(b'\xc3\xa0'), bytearray(b'apprendre.')]

LST_Mots = BYA_Introduction.split ( b"a" , 2 )

print ( LST_Mots ) retourne [bytearray(b'Python est un l'), bytearray(b'ng'), bytearray(b'ge de programmation puissant et facile \xc3\xa0 apprendre.')]

LST_Mots = BYA_Introduction.split ( b"programmation" )

print ( LST_Mots ) retourne [bytearray(b'Python est un langage de '), bytearray(b' puissant et facile \xc3\xa0 apprendre.')]

LST_Mots = BYA_Introduction.split ( b"m" )

print ( LST_Mots ) retourne [bytearray(b'Python est un langage de progra'), bytearray(b''), bytearray(b'ation puissant et facile \xc3\xa0 apprendre.')]