الفرق بين المراجعتين لصفحة: «Ruby/Kernel/Integer»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Kernel]] | [[تصنيف: Ruby Kernel]] | ||
يحول التابع <code>Integer</code> | يحول التابع <code>Integer</code> المعامل المُمرَّر إليه إلى عدد صحيح (<code>[[Ruby/Integer|Integer]]</code>). | ||
==البنية العامة== | |||
<syntaxhighlight lang="ruby">Integer(arg, base=0) → integer</syntaxhighlight>تُحوّل الأنواع العددية مباشرة (مع اقتطاع الفواصل العشرية [floating point numbers]). المعامل <code>base</code> المٌعطى يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان <code>arg</code> من النوع <code>[[Ruby/String|String]]</code>، وفي حال عدم تمرير الوسيط <code>base</code> أو كان يساوي الصفر، فسيتم احتساب مؤشرات الأساس (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع <code>[[Ruby/String/to i|String.to_i]]</code>. تُحوّل القيم غير النصية أولًا عبر محاولة استدعاء التابع <code>to_int</code> ثم استدعاء <code>to_i</code>. | |||
في حال تمرير القيمة <code>nil</code> فسيُطلق | في حال تمرير القيمة <code>nil</code>، فسيُطلق الخطأ <code>[[Ruby/TypeError|TypeError]]</code>. | ||
==المعاملات== | ==المعاملات== | ||
| سطر 14: | سطر 14: | ||
=== <code>base</code> === | === <code>base</code> === | ||
يمثل أساس التمثيل النصي للأعداد الصحيحة | يمثل أساس التمثيل النصي للأعداد الصحيحة. | ||
==القيمة | ==القيمة المعادة== | ||
يعاد ناتج تحويل المعامل <code>arg</code> إلى عدد صحيح (<code>[[Ruby/Integer|Integer]]</code>). | |||
==أمثلة== | ==أمثلة== | ||
| سطر 26: | سطر 26: | ||
Integer("0930", 10) #=> 930 | Integer("0930", 10) #=> 930 | ||
Integer("111", 2) #=> 7 | Integer("111", 2) #=> 7 | ||
Integer(nil) #=> TypeError | Integer(nil) #=> TypeError</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/Kernel/Array|Array]]</code>: يعيد | * التابع <code>[[Ruby/Kernel/Array|Array]]</code>: يعيد المعامل المعطى على شكل مصفوفة (<code>[[Ruby/Array|Array]]</code>). | ||
* التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول | * التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول المعامل المعطى إلى [[Ruby/Hash|جدول Hash]]. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-Integer قسم | *[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-Integer قسم التابع Integer في الصنف Kernel في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 08:20، 15 نوفمبر 2018
يحول التابع Integer المعامل المُمرَّر إليه إلى عدد صحيح (Integer).
البنية العامة
Integer(arg, base=0) → integer
تُحوّل الأنواع العددية مباشرة (مع اقتطاع الفواصل العشرية [floating point numbers]). المعامل base المٌعطى يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع String، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر، فسيتم احتساب مؤشرات الأساس (0 و 0b و 0x). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع String.to_i. تُحوّل القيم غير النصية أولًا عبر محاولة استدعاء التابع to_int ثم استدعاء to_i.
في حال تمرير القيمة nil، فسيُطلق الخطأ TypeError.
المعاملات
arg
الوسيط المراد تحويله إلى عدد صحيح.
base
يمثل أساس التمثيل النصي للأعداد الصحيحة.
القيمة المعادة
يعاد ناتج تحويل المعامل arg إلى عدد صحيح (Integer).
أمثلة
مثال على استخدام التابع Integer:
Integer(123.999) #=> 123
Integer("0x1a") #=> 26
Integer(Time.new) #=> 1204973019
Integer("0930", 10) #=> 930
Integer("111", 2) #=> 7
Integer(nil) #=> TypeError
انظر أيضا
- التابع
Array: يعيد المعامل المعطى على شكل مصفوفة (Array). - التابع
Hash: يحول المعامل المعطى إلى جدول Hash.