DESCRIPTION.

Retourne un nouveau tableau d'octets d'une longueur minimale données, remplie en début de tableau d'autant de b"0" (zéro) que nécessaire, pour atteindre cette longueur.

SYNTAXE.

BYA_Texte = tableau.zfill ( longueur )

BYA_Texte = ⇨ variable qui recevra la nouvelle chaine [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

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

longueur ⇨ taille minimale du tableau [ OBLIGATOIRE ]

REMARQUES.

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

longueur doit être un int ( ) indiquant le nombre minimum d'éléments que devra contenir le nouveau tableau d'octets. Si le nombre d'éléments dans tableau est supérieur à longueur, la méthode bytearray ( ).zfill ( ) retournera une nouvelle référence pour tableau sans modification. Sinon il s'agira bien de deux bytearray ( ) différents. 

Si tableau commence par b"-" (signe moins) ou b"+" (signe plus), les b"0" (zéro) ajoutés seront insérés après ce signe.

La méthode bytearray ( ).zfill ( ) permet principalement une présentation fluide des nombres, mais tableau peut contenir des caractères autres que des chiffres, pour des valeurs hexadécimales par exemple.

Bien que tableau soit du type bytearray ( ), un tableau d'octets muable, la méthode bytearray ( ).zfill ( ) ne modifie pas l'objet appelant, mais crée et retourne un nouveau objet bytearray ( ) avec les modifications demandées.

EXEMPLES.

print ( bytearray ( b"123" ).zfill ( 7 ) ) retourne bytearray(b'0000123')

print ( bytearray ( b"+123" ).zfill ( 7 ) ) retourne bytearray(b'+000123')

print ( bytearray ( b"-123" ).zfill ( 7 ) ) retourne bytearray(b'-000123')

print ( bytearray ( b"1234567" ).zfill ( 3 ) ) retourne bytearray(b'1234567')

print ( bytearray ( b"abc" ).zfill ( 7 ) ) retourne bytearray(b'0000abc')

print ( bytearray ( b"+abc" ).zfill ( 7 ) ) retourne bytearray(b'+000abc')

print ( bytearray ( b"-abc" ).zfill ( 7 ) ) retourne bytearray(b'-000abc')