Ruby/Integer
يمثل الصنف Integer الأعداد الصحيحة. لا يمكن إضافة تابع أحادي (singleton method) إلى كائن من الصنف Integer، وأي محاولة لفعل ذلك ستؤدي إلى إطلاق الخطأ TypeError.
الثوابت (Constants)
GMP_VERSION
يمثِّل النسخة GMP المُحمّلة.
توابع الصنف العامة (Public Class Methods)
sqrt
يعيد التابع sqrt الجذر التربيعي الصحيح للعدد الصحيح الموجب المُمرر إليه.
توابع الكائن العامة (Public Instance Methods)
%
يعيد المعامل % باقي عملية القسمة الصحيحة بين عددين.
&
ينفذ المعامل & العملية AND بين بتات العددين المعطيين.
*
يعيد المعامل * ناتج عملية الضرب بين عددين.
**
يعيد المعامل ** ناتج عملية رفع للعدد int الأساس إلى قوة العدد numeric (الأس).
+
يعيد المعامل + ناتج عملية الجمع بين عددين.
-
يعيد المعامل - ناتج عملية الطرح بين عددين.
-
إن استُعمِل المعامل - بالشكل -int، فسيعيد القيمة المعاكسة للعدد int الصحيح الموجب (أي القيمة السالبة إن كان int موجبًا أو العكس).
/
يعيد المعامل / ناتج عملية القسمة بين عددين.
>
يعيد المعامل > القيمة true إن كانت قيمة العدد الصحيح الواقع على يساره أصغر من قيمة العدد الصحيح المواقع على يمينه.
<<
يزيح المعامل >> العدد الصحيح المعطى إلى اليسار بقدار محدَّد من المنازل، أو إلى اليمين إن كانت قيمة مقدار الإزاحة سالبةً.
<=
يعيد المعامل => القيمة true إن كانت قيمة العدد الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه.
<=>
يعيد معامل الموازنة <=> عددًا صحيحًا (-1 أو 0 أو +1) إذا كان العدد الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي.
==
يعيد المعامل == القيمة true إن كان العدد الصحيح الواقع على يساره يساوي القيمة الواقعة على يمينه.
<
يعيد المعامل < القيمة true إن كانت قيمة العدد الواقع على يساره أكبر من قيمة العدد الآخر الواقع على يمينه.
=<
يعيد التابع =< القيمة true إن كانت قيمة العدد الواقع على يساره أكبر من أو تساوي قيمة العدد الآخر الواقع على يمينه.
>>
يزيح المعامل << العدد الصحيح المعطى إلى اليمين بقدار محدَّد من المنازل، أو إلى اليسار إن كانت قيمة مقدار الإزاحة سالبةً.
[]
يعيد معامل الفهرسة [] البت الموجودة عند الموضع n في التمثيل الثنائي للعدد الصحيح المعطى.
^
ينفذ المعامل ^ العملية XOR الثنائية بين بتات العددين المعطيين.
|
ينفذ المعامل | العملية OR بين بتات العددين المعطيين.
~
يعيد المعامل ~ مكمل العدد الذي استُدعي معه، إذ يقلب قيمة كل بت من بتات العدد.
abs
يعيد القيمة المطلقة للعدد الذي استُدعي معه.
allbits?
يتحقق إن كانت قيم كل بتات ناتج تطبيق العملية & على العدد الصحيح المعطى مع القناع الممرر إليه تساوي الواحد.
anybits?
يتحقق إن كانت قيمة إحدى بتات ناتج تطبيق العملية & على العدد الصحيح المعطى مع القناع الممرر إليه تساوي الواحد.
bit_length
يعيد عدد بتات العدد الذي استُدعي معه.
ceil
يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه وبدقة (precision) تساوي العدد الممرر إليه (القيمة الابتدائية هي 0) .
chr
يعيد سلسلة نصية تحتوي على الحرف الذي تمثله قيمة العدد الذي استُدعي معه حسب الترميز المحدد.
coerce
يعيد مصفوفة تضم القيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، وذلك عبر تحويل numeric إلى Bignum.
denominator
يعيد القيمة 1.
digits
يفكك العدد الذي استٌدعي معه عبر تقسيم الأرقام التي تكوّنه من اليسار إلى اليمين، بحيث تكون أصغر من الوسيط الممرر إليه ثم يضعها في مصفوفة، مع وضع الرقم الأقل أهمية (least significant digit) في بداية المصفوفة.
div
يعيد ناتج عملية قسمة العدد الذي استدعي معه على العدد الذي مُرِّر إليه.
divmod
يعيد التابع divmod مصفوفة تحتوي على حاصل (quotient) وباقي (modulus) عملية تقسيم العدد الذي استٌدعي التابع معه على العدد المُمرّر إليه.
downto
يكرر التابع downto تنفيذ الكتلة البرمجية المعطاة مع تمرير الأعداد تنازليًا بداية من العدد الذي استُدعيت معه وحتى العدد المعطى.
even?
يتحقق إن كان العدد الذي استٌدعي معه زوجيًا.
fdiv
يعيد العدد العشري الناتج عن عملية قسمة العدد الذي استُدعي معه على العدد المُمرّر إليه.
floor
يعيد أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة (precision) تساوي العدد المعطى (القيمة الابتدائية هي 0).
gcd
يعيد أكبر قاسم مشترك للعدد الذي استُدعي معه والعدد المٌعطى.
gcdlcm
يعيد مصفوفة تضم أكبر قاسم مشترك وأصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعط؛ أي [gcd, lcm].
inspect
هو اسم بديل للتابع to_s.
nteger?
يعيد القيمة true دائمًا إن كان العدد المستدعى معه صحيح.
lcm
يعيد أصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعطى.
magnitude
يعيد القيمة المطلقة للعدد الذي استُدعي معه.
modulo
يعيد باقي عملية قسمة العدد الذي استُدعي معه على العدد المُعطى.
next
يعيد العدد التالي للعدد الصحيح الذي استُدعي معه. أي يعيد القيمة int+1.
nobits?
يعيد التابع nobits? القيمة true إن كانت قيم كل البتات الناتجة عن العملية int & mask تخالف واحد.
numerator
يعيد التابع numerator العدد الذي استُدعي معه.
odd?
يتحقق إن كان العدد الذي استٌدعي معه فرديًا.
ord
يعيد التابع ord العدد الذي استٌدعي معه.
pow
يعيد التابع pow الأس التوافقي (modular exponentiation ) للعدد الذي استُدعي معه والعددين لمٌمرّرين (الثاني اختياري).
pred
يعيد التابع pred العدد السابق على العدد الذي استُدعي معه. أي int-1.
rationalize
يعيد التابع rationalize قيمة العدد الذي استُدعي معه على شكل عدد جذري (rational). الوسيط المُمرّر eps يُتجاهل دائمًا.
remainder
يعيد التابع remainder باقي عملية قسمة العدد int على العدد numeric (انظر فقرة البنية العامة).
round
يعيد التابع round العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي0) .
size
يعيد التابع size عدد البتات في تمثيل الآلة (machine representation) للعدد الذي استُدعي معه، النتيجة تتعلق بالآلة المستخدمة.
succ
يعيد التابع succ العدد الموالي للعدد الذي استُدعي معه. أي int+1.
times
يقوم التابع times بتكرار تنفيذ الكتلة البرمجية المعطاة عددًا من المرات يساوي قيمة العدد الذي استُدعي معه، مع تمرير قيم عددية ابتداء من الصفر وحتى العدد int - 1.
to_f
يحول التابع to_f العدد الذي استُدعي معه من الصنف Integer إلى الصنف float، في حال لم يكن التحويل ممكنًا، فستُعاد اللانهاية.
to_i
يعيد التابع to_i العدد الذي استُدعي معه دون تغيير يكافئ (to_int).
to_int
يعيد التابع to_int العدد الذي استُدعي معه دون تغيير يكافئ (to_i).
to_r
يحول التابع to_r العدد الذي استُدعي معه إلى عدد جذري (rational).
to_s
يعيد التابع to_s سلسلة نصية تحتوي على التمثيل الموضعي (place-value representation) للعدد الذي استُدعي معه، وفق الأساس (radix) المعطىbase (محصور بين 2 و 36)
truncate
يعيد التابع truncate العدد الذي استُدعي معه مُقتطعًا (truncated) إلى دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .
upto
يقوم التابع upto بتكرار تنفيذ الكتلة البرمجية المعطاة مع تمرير الأعداد تصاعديًا بداية من العدد الذي استُدعيت معه وحتى العدد المعطى limit.