الفرق بين المراجعتين ل"Python/int/to bytes"

من موسوعة حسوب
< Python‏ | int
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - ':الدالة' ب':التابع')
 
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>int.to_bytes()‎</code> في بايثون}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:التابع <code>int.to_bytes()‎</code> في بايثون}}</noinclude>
تعيد الدالة <code>to_bytes()‎</code> مصفوفة من البايتات تمثّل [[Python/int|عددًا صحيحًا]].
+
يعيد التابع <code>to_bytes()‎</code> مصفوفة من البايتات تمثّل [[Python/int|عددًا صحيحًا]].
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 10: سطر 10:
  
 
=== <code>length</code> ===
 
=== <code>length</code> ===
عدد البايتات التي تستخدمها الدالة لتمثيل [[Python/int|العدد الصحيح]]. في حال كان [[Python/int|العدد الصحيح]] غير قابل للتمثيل باستخدام العدد البايتات المحدّد في هذا الوسيط فستطلق اللغة [[Python/exceptions|الاستثناء]] <code>OverflowError</code>.
+
عدد البايتات التي يستخدمها التابع لتمثيل [[Python/int|العدد الصحيح]]. في حال كان [[Python/int|العدد الصحيح]] غير قابل للتمثيل باستخدام العدد البايتات المحدّد في هذا الوسيط فستطلق اللغة [[Python/exceptions|الاستثناء]] <code>[[Python/built-in exceptions#OverflowError|OverflowError]]</code>.
  
 
=== <code>byteorder</code> ===
 
=== <code>byteorder</code> ===
سطر 16: سطر 16:
  
 
=== <code>signed</code> ===
 
=== <code>signed</code> ===
يحدّد هذا الوسيط ما إذا سيتم استخدام متمّم الاثنين (two’s complement) لتمثيل العدد الصحيح. إن أخذ هذا الوسيط القيمة <code>False</code> ومُرّر إلى الدالة [[Python/int|عدد صحيح]] سالب، تطلق اللغة [[Python/exceptions|الاستثناء]] <code>OverflowError</code>. القيمة الافتراضية لهذا الوسيط هي <code>False</code>.
+
يحدّد هذا الوسيط ما إذا سيتم استخدام المتمم الثنائي (two’s complement) لتمثيل العدد الصحيح. إن أخذ هذا الوسيط القيمة <code>False</code> ومُرّر إلى الدالة [[Python/int|عدد صحيح]] سالب، تطلق اللغة [[Python/exceptions|الاستثناء]] <code>[[Python/built-in exceptions#OverflowError|OverflowError]]</code>. القيمة الافتراضية لهذا الوسيط هي <code>False</code>.
  
'''ملاحظة''': هذه الدالة جديدة في الإصدار 3.2.
+
'''ملاحظة''': هذا التابع جديدٌ في الإصدار 3.2.
  
 
== أمثلة ==
 
== أمثلة ==
يوضح المثال التالي النتائج المعادة من استخدام الدالة <code>to_bytes()‎</code> مع معاملات مختلفة:<syntaxhighlight lang="python3">
+
يوضح المثال التالي النتائج المعادة من استخدام التابع <code>to_bytes()‎</code> مع معاملات مختلفة:<syntaxhighlight lang="python3">
 
>>> (1024).to_bytes(2, byteorder='big')
 
>>> (1024).to_bytes(2, byteorder='big')
 
b'\x04\x00'
 
b'\x04\x00'
سطر 35: سطر 35:
 
== انظر أيضًا ==
 
== انظر أيضًا ==
 
* [[Python/int|الأعداد الصحيحة في بايثون.]]
 
* [[Python/int|الأعداد الصحيحة في بايثون.]]
 +
* التابع <code>[[Python/int/bit length|int.bit_length()‎]]</code>: إعادة البتات المطلوبة لتمثيل <nowiki/>[[Python/int|عدد صحيح]] بالصيغة الثنائية، مع استثناء الإشارة والأصفار الأولية.
 +
* التابع <code>[[Python/int/from bytes|int.from_bytes()‎]]</code>: إعادة العدد الصحيح الذي تمثّله مصفوفة البايتات الممرّرة إلى التابع.
  
 
== مصادر ==
 
== مصادر ==
 
* [https://docs.python.org/3/library/stdtypes.html#int.to_bytes قسم to_bytes في صفحة Types في توثيق بايثون الرسمي.]
 
* [https://docs.python.org/3/library/stdtypes.html#int.to_bytes قسم to_bytes في صفحة Types في توثيق بايثون الرسمي.]
 
[[تصنيف:Python]]
 
[[تصنيف:Python]]
[[تصنيف:Python Function]]
+
[[تصنيف:Python Method]]
[[تصنيف:Python Built-in Functions]]
+
[[تصنيف:Python Types]]
 +
[[تصنيف:Python Int]]

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

يعيد التابع to_bytes()‎ مصفوفة من البايتات تمثّل عددًا صحيحًا.

البنية العامة

x.to_bytes()

المعاملات

length

عدد البايتات التي يستخدمها التابع لتمثيل العدد الصحيح. في حال كان العدد الصحيح غير قابل للتمثيل باستخدام العدد البايتات المحدّد في هذا الوسيط فستطلق اللغة الاستثناء OverflowError.

byteorder

يحدد هذا الوسيط ترتيب البايتات المستخدمة لتمثيل العدد الصحيح. يأخذ هذا المعامل القيمة "big" ويصبح البايت الأكثر أهمّية في بداية مصفوفة البايتات، ويأخذ القيمة "little" فيصبح البايت الأكثر أهمّية في نهاية مصفوفة البايتات. وللحصول على الترتيب المعتمد في النظام المضيف يمكن استخدام sys.byteorder كقيمة لهذا الوسيط.

signed

يحدّد هذا الوسيط ما إذا سيتم استخدام المتمم الثنائي (two’s complement) لتمثيل العدد الصحيح. إن أخذ هذا الوسيط القيمة False ومُرّر إلى الدالة عدد صحيح سالب، تطلق اللغة الاستثناء OverflowError. القيمة الافتراضية لهذا الوسيط هي False.

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

أمثلة

يوضح المثال التالي النتائج المعادة من استخدام التابع to_bytes()‎ مع معاملات مختلفة:

>>> (1024).to_bytes(2, byteorder='big')
b'\x04\x00'
>>> (1024).to_bytes(10, byteorder='big')
b'\x00\x00\x00\x00\x00\x00\x00\x00\x04\x00'
>>> (-1024).to_bytes(10, byteorder='big', signed=True)
b'\xff\xff\xff\xff\xff\xff\xff\xff\xfc\x00'
>>> x = 1000
>>> x.to_bytes((x.bit_length() + 7) // 8, byteorder='little')
b'\xe8\x03'

انظر أيضًا

مصادر