الدالة 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

انظر أيضًا

• الأعداد الصحيحة في بايثون.

مصادر

• قسم from_bytes في صفحة Types في توثيق بايثون الرسمي.