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 bytes ( ) 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 bytes ( ).split ( ) sont dans le même ordre que leur présence dans tableau, même si quota est présent.

EXEMPLE.

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

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

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

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

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

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

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

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

LST_Mots = BYT_Introduction.split ( )

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

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

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

LST_Mots = BYT_Introduction.split ( b"programmation" )

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

LST_Mots = BYT_Introduction.split ( b"m" )

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