int.to_bytes() Int to bytes
Last updated: 2026-09-22
int.to_bytes() Int to bytes
int.to_bytes(length, byteorder) converts an int to bytes; byteorder is 'big' or 'little'.
| Category | Number Methods |
|---|---|
| Kind | Built-in Type Method |
| Python Version | all |
📝 Syntax
int.to_bytes()⚙️ Parameters
| length Required | The length of the resulting bytes object. |
|---|---|
| byteorder Required | Byte order: 'big' for most-significant first, 'little' for least-significant first. |
| signed Optional | Whether to use two's complement for signed integers.（Default：False） |
Returns：bytes. The integer converted to bytes with the given length and byte order.
Mutates the original：No (returns a new object)
💥 Raises
OverflowError— Raised when the integer does not fit in length bytes.ValueError— Raised when byteorder is invalid, or signed is True and the integer is negative.
▶ Example
Edit the code, press Run, and see the result in the output panel:
Output：
b'\x00\xff'
b'\xff\x00'💡 Related Cases
More case studies coming soon — check back later.
❓ FAQ
QWhat parameters does to_bytes() have?
ABoth length (number of bytes) and byteorder ('big' for most significant first / 'little' for least significant first) are required; signed is optional and defaults to False.
QWhat happens when length is not enough?
AAn OverflowError: int too big to convert is raised.
QCan negative numbers be converted?
ANot by default (raises OverflowError); with signed=True it converts using two's complement: (-1).to_bytes(2, 'big', signed=True) gives b'\xff\xff'.
QWhat happens when byteorder is misspelled?
AA ValueError is raised; only 'big' and 'little' are accepted.
