DESCRIPTION.

Retourne un tableau d'octets de type bytes ( ) représentant un nombre entier.

SYNTAXE.

BYT_Entier = entier.to_bytes ( taille , ordre , signe )

BYT_Entier = ⇨ variable qui recevra la valeur [ optionnel ]

entier ⇨ valeur numérique valide entière [ OBLIGATOIRE ]

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

taille ⇨ nombre d'octets dans le tableau [ OBLIGATOIRE ]

ordre ⇨ place de l'octet le plus significatif [ OBLIGATOIRE ]

signe ⇨ précise si le nombre peut être signé [ optionnel ]

REMARQUES.

entier doit un int ( ) ou une expression valide.

taille doit un int ( ) et indique combien d'éléments (octets) contiendra le tableau d'octets retourné. Si la conversion de entier utilise moins d'octets que taille, le tableau sera complété avec autant d'octets valant b"\x00" que nécessaire. Si taille est insuffisant pour convertir entier, Python lèvera une exception.

Par défaut ordre vaut byteorder = "big", ce qui place l'octet le plus significatif en début de tableau. Pour inverser cette arrangement des octets dans le tableau on utilisera byteorder = "little" pour ordre.

Si signe vaut signed = True, cela autorise entier à être un nombre négatif, en plaçant un complément à deux pour la représentation du signe.  Si signed = False, valeur par défaut, alors les nombres négatifs feront lever une exception à Python. S'il l'argument signe est utilisé, il  doit être nommé avec signed = ???.

Voir bytes ( ) pour plus d'informations sur les tableaux d'octets non muables.

EXEMPLES.

print ( ( 12345 ).to_bytes ( 5 , "big" ) ) retourne b'\x00\x00\x0009'

Test = 12345

print ( Test.to_bytes ( 5 , "big" ) ) retourne b'\x00\x00\x0009'

print ( Test.to_bytes ( 10 , "big" ) ) retourne b'\x00\x00\x00\x00\x00\x00\x00\x0009'

print ( Test.to_bytes ( 10 , "little" ) ) retourne b'90\x00\x00\x00\x00\x00\x00\x00\x00'

print ( ( -12345 ).to_bytes ( 5 , "big" ) ) retourne verflowError: can't convert negative int to unsigned

print ( ( -12345 ).to_bytes ( 5 , "big" , signed = True ) ) retourne b'\xff\xff\xff\xcf\xc7'

print ( ( -12345 ).to_bytes ( 5 , "little" , signed = True ) ) retourne b'\xc7\xcf\xff\xff\xff'

print ( ( -12345 ).to_bytes ( 5 , "little" , signed = False ) ) retourne OverflowError: can't convert negative int to unsigned

BYT_Test = ( 9876 ).to_bytes ( 7 , "big" )

print ( BYT_Test ) retourne b'\x00\x00\x00\x00\x00&\x94'

print ( type ( BYT_Test ) ) retourne <class 'bytes'>