الفرق بين المراجعتين لصفحة: «Python/int/from bytes»

من موسوعة حسوب
< Python‏ | int
لا ملخص تعديل
ط استبدال النص - ':الدالة' ب':التابع'
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>int.from_bytes()‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>int.from_bytes()‎</code> في بايثون}}</noinclude>
تعيد دالة <code>from_bytes()‎</code> [[Python/int|العدد الصحيح]] الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة.
يعيد التابع <code>from_bytes()‎</code> [[Python/int|العدد الصحيح]] الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة.


== البنية العامة ==
== البنية العامة ==
سطر 16: سطر 16:


=== <code>signed</code> ===
=== <code>signed</code> ===
يحدّد هذا الوسيط ما إذا سيُستخدَم متمّم الاثنين (two’s complement) لتمثيل [[Python/int|العدد الصحيح]].
يحدّد هذا الوسيط ما إذا سيُستخدَم المتمم الثنائي (two’s complement) لتمثيل [[Python/int|العدد الصحيح]].


'''ملاحظة:''' هذه الدالة جديدة في الإصدار 3.2 من بايثون.
'''ملاحظة:''' هذا التابع جديدٌ في الإصدار 3.2 من بايثون.


== أمثلة ==
== أمثلة ==
يوضّح المثال التالي طريقة استخدام الدالة <code>from_bytes()</code>‎ والنتائج التي تعيدها عند استخدام معاملات مختلفة:<syntaxhighlight lang="python3">
يوضّح المثال التالي طريقة استخدام التابع <code>from_bytes()</code>‎ والنتائج التي تعيدها عند استخدام معاملات مختلفة:<syntaxhighlight lang="python3">
>>> int.from_bytes(b'\x00\x10', byteorder='big')
>>> int.from_bytes(b'\x00\x10', byteorder='big')
16
16
سطر 36: سطر 36:
== انظر أيضًا ==
== انظر أيضًا ==
* [[Python/int|الأعداد الصحيحة في بايثون.]]
* [[Python/int|الأعداد الصحيحة في بايثون.]]
* التابع <code>[[Python/int/bit length|int.bit_length()‎]]</code>: إعادة البتات المطلوبة لتمثيل عدد صحيح بالصيغة الثنائية، مع استثناء الإشارة والأصفار الأولية.
* التابع <code>[[Python/int/to bytes|int.to_bytes()‎]]</code>: إعادة مصفوفة من البايتات تمثّل عددًا صحيحًا.


== مصادر ==
== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#int.from_bytes قسم from_bytes في صفحة Types في توثيق بايثون الرسمي.]
* [https://docs.python.org/3/library/stdtypes.html#int.from_bytes قسم التابع from_bytes في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Method]]
[[تصنيف:Python Built-in Functions]]
[[تصنيف:Python Types]]
[[تصنيف:Python Int]]

المراجعة الحالية بتاريخ 11:58، 10 يونيو 2018

يعيد التابع 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

انظر أيضًا

مصادر