الدالة int.from_bytes() في بايثون
يعيد التابع from_bytes() العدد الصحيح الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة.
البنية العامة
x.from_bytes()
المعاملات
bytes
يجب أن يكون هذا الوسيط كائنًا شبيهًا بالبايتات أو كائنًا يمكن المرور على عناصره (iterable) وينتج البايتات.
bytesorder
يحدد هذا الوسيط ترتيب البايتات المستخدمة لتمثيل العدد الصحيح. يأخذ هذا المعامل القيمة "big" ويصبح البايت الأكثر أهمّية في بداية مصفوفة البايتات، ويأخذ القيمة "little" فيصبح البايت الأكثر أهمّية في نهاية مصفوفة البايتات. وللحصول على الترتيب المعتمد في النظام المضيف يمكن استخدام sys.byteorder كقيمة لهذا الوسيط.
signed
يحدّد هذا الوسيط ما إذا سيُستخدَم المتمم الثنائي (two’s complement) لتمثيل العدد الصحيح.
ملاحظة: هذا التابع جديدٌ في الإصدار 3.2 من بايثون.
أمثلة
يوضّح المثال التالي طريقة استخدام التابع from_bytes() والنتائج التي تعيدها عند استخدام معاملات مختلفة:
>>> int.from_bytes(b'\x00\x10', byteorder='big')
16
>>> int.from_bytes(b'\x00\x10', byteorder='little')
4096
>>> int.from_bytes(b'\xfc\x00', byteorder='big', signed=True)
-1024
>>> int.from_bytes(b'\xfc\x00', byteorder='big', signed=False)
64512
>>> int.from_bytes([255, 0, 0], byteorder='big')
16711680
انظر أيضًا
- الأعداد الصحيحة في بايثون.
- التابع
int.bit_length(): إعادة البتات المطلوبة لتمثيل عدد صحيح بالصيغة الثنائية، مع استثناء الإشارة والأصفار الأولية. - التابع
int.to_bytes(): إعادة مصفوفة من البايتات تمثّل عددًا صحيحًا.