Python/int

العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن فاصلة عشرية، ويمكن تمثيله بالنظام العشري (decimal، الأساس 10) والست عشري (hexadecimal، الأساس 16) والثماني (octal، الأساس 8) والثنائي (binary، الأساس 2).

يجب أن يكون العدد الصحيح مسبوقًا بالقيمة 0o لاستخدامه في النظام الثماني، وبالقيمة 0x لاستخدامه في النظام الست عشري، وبالقيمة 0b لاستخدامه في النظام الثنائي، وفيما يلي مجموعة من الأمثلة:

>>> q = 3571       # عدد صحيح في النظام العشري
>>> q = -424       # عدد صحيح سالب
>>> q = 0o675      # في النظام الثماني
>>> q = 0xAB23     # في النظام الست عشري
>>> q = 0b11001010 # في النظام الثنائي
>>> type(q)        # التحقق من نوع المتغير
<class 'int'>

تمتلك الأعداد الصحيحة في بايثون دقّة غير محدودة unlimited precision (أي تعطي اللغة نتائج دقيقة عند استخدام أرقام كبيرة جدًّا).

التحويل إلى الأعداد الصحيحة

يمكن استخدام الدالة الداخلية int()‎ لتحويل الأنواع المختلفة إلى أعداد صحيحة، وتعيد الدالة القيمة 0 في حال عدم وجود وسائط.

إن كان المتغيّر x يحمل قيمة عددية تعيد الدالةُ int()‎ التابعَ x.__int__()‎، أما الأعداد العشرية (ذات النقطة العائمة floating point) فتختصر باتجاه الصفر.

أمثلة:

>>> x = 3.9
>>> int(x)
3
>>> y = -4.3
>>> int(y)
4
>>> int() # تعيد الدالة القيمة صفر عند غياب الوسائط
0
>>> x = -4.3
>>> x.__int__()
-4
>>> x = -4.9
>>> x.__int__()
-4
>>> x = 4.9
>>> x.__int__()
4

إن لم يحمل المتغيرُ قيمةً عدديةً، فإنّ قيمته يجب أن تكون إمّا سلسلةً نصية، أو بايت (bytes)، أو مصفوفة بايتات (bytearray) تُمثِّل رموز الأرقام. يمكن أن تسبق هذه الرموز علامتا + أو - (دون إضافة ما يفصل بين الرموز والعلامة) وأن تحاط بمسافات بيضاء. يتضمن الرمز ذو الأساس n (مثل أساس العد العشري، أو الثماني، أو الست عشري) أعدادًا من 0 إلى n-1، مع a إلى z (أو A إلى Z) والتي تمتلك القيم 10 إلى 35 إن لزم الأمر. الأساس الافتراضي هو 10 والأرقام المسموح بها هي 0 و من 2 إلى 36. يمكن لرموز الأرقام في النظام الثنائي والثماني والست عشري أن تكون مسبوقة اختياريًا بالقيم 0b/0B, 0o/0O, أو 0x/0X على التوالي، كما هو الحال في رموز الأرقام المستخدمة في الشيفرة.

يؤدي استخدام الأساس 0 إلى تفسير الناتج بنفس طريقة تفسير رموز الأرقام في الشيفرة، بحيث يكون الأساس الحقيقي هو 2، أو 8، أو 10، أو 16، وهكذا تكون العبارة int('010', 0)‎ خطأ، أما العبارتان int('010')‎ و int('010', 8)‎ فصحيحتان.

مثال

>>> a = "12"
>>> b = "13"
>>> int(a) + int(b)
25
>>> int('0xFF', 16)
255
>>> int('0o10', 8)
8

الدوال التابعة للكائن int

int.bit_length()‎

تعيد الدالة عدد البتات المطلوبة لتمثيل عدد صحيح بالصيغة الثنائية، مع استثناء الإشارة والأصفار الأولية.

int.to_bytes()‎

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

int.from_bytes()‎

تعيد الدالة العدد الصحيح الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة.

مصادر

• صفحتا Built-in Types  و Built-in Functions في توثيق بايثون الرسمي.