الفرق بين المراجعتين لصفحة: «Ruby/Kernel/Integer»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Integer</code> الخاص بالصنف <code>Kernel</code> في روبي}}</noinclude> تصنيف: Ruby تصن...' |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق |
||
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Kernel]] | [[تصنيف: Ruby Kernel]] | ||
يحول | يحول التابع <code>Integer</code> المعامل المُمرَّر إليه إلى عدد صحيح (<code>[[Ruby/Integer|Integer]]</code>). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">Integer(arg, base=0) → integer</syntaxhighlight> | <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>[[Ruby/TypeError|TypeError]]</code>. | |||
==المعاملات== | ==المعاملات== | ||
==القيمة | === <code>arg</code> === | ||
الوسيط المراد تحويله إلى عدد صحيح. | |||
=== <code>base</code> === | |||
يمثل أساس التمثيل النصي للأعداد الصحيحة. | |||
==القيمة المعادة== | |||
يعاد ناتج تحويل المعامل <code>arg</code> إلى عدد صحيح (<code>[[Ruby/Integer|Integer]]</code>). | |||
==أمثلة== | ==أمثلة== | ||
سطر 17: | سطر 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.