int.to_bytes() تحويل العدد الصحيح إلى سلسلة بايتات
آخر تحديث: 2026-09-22
int.to_bytes() تحويل العدد الصحيح إلى سلسلة بايتات
int.to_bytes(length, byteorder) يحوّل العدد الصحيح إلى سلسلة بايتات بالطول المحدد؛ تأخذ byteorder القيمة 'big' أو 'little'.
| التصنيف | دوال الأرقام |
|---|---|
| النوع | دوال الأنواع المدمجة |
| إصدار بايثون | all |
📝 الصياغة
int.to_bytes()⚙️ المعاملات
| length مطلوب | The length of the resulting bytes object. |
|---|---|
| byteorder مطلوب | Byte order: 'big' for most-significant first, 'little' for least-significant first. |
| signed اختياري | Whether to use two's complement for signed integers.（القيمة الافتراضية：False） |
القيمة المُعادة：bytes. The integer converted to bytes with the given length and byte order.
يعدّل الكائن الأصلي：لا (يُعيد كائنًا جديدًا)
💥 الاستثناءات
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.
▶ مثال
عدّل الكود واضغط تشغيل لرؤية النتيجة في لوحة المخرجات:
المخرجات：
b'\x00\xff'
b'\xff\x00'💡 حالات ذات صلة
المزيد من الحالات قادم قريباً — تابعونا.
❓ أسئلة شائعة
Qما المُعاملات التي تأخذها الدالة to_bytes()؟
Aكلا من length (عدد البايتات) و byteorder ('big' للبايت الأكثر أهمية أولاً / 'little' للبايت الأقل أهمية أولاً) إلزاميان؛ أما signed فهو اختياري وقيمته الافتراضية هي False.
Qماذا يحدث عندما لا تكون length كافية؟
Aيتم إطلاق OverflowError: int too big to convert.
Qهل يمكن تحويل الأعداد السالبة؟
Aليس افتراضيًا (يُطلق OverflowError)؛ عند تعيين signed=True يُحوَّل باستخدام تمثيل المتمم الثنائي: تعيد (-1).to_bytes(2, 'big', signed=True) القيمة b'\xff\xff'.
Qماذا يحدث إذا أُخطئ في كتابة byteorder؟
Aيتم إطلاق ValueError؛ فالقيمتان المقبولتان هما 'big' و 'little' فقط.
