الفرق بين المراجعتين لصفحة: «Ruby/Kernel/Integer»

من موسوعة حسوب
< Ruby‏ | Kernel
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Integer‎</code> الخاص بالصنف <code>Kernel</code> في روبي}}</noinclude> تصنيف: Ruby تصن...'
 
ط مراجعة وتدقيق
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Kernel]]
[[تصنيف: Ruby Kernel]]
يحول arg إلى عدد صحيح (<code>Integer</code>). تُحوّل الأنواع العددية (<code>Numeric</code>) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة.  إن كان arg من النوع <code>String</code> ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع ا<code>String#to_i</code>.  تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع <code>to_int</code> ، ثم استدعاء <code>to_i</code>. في حال تمرير <code>nil</code> فسيُطلق خطأ <code>TypeError</code>.
يحول التابع <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>
</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/Kernel/Array|Array]]</code>: يحول arg إلى عدد صحيح (<code>Integer</code>). تُحوّل الأنواع العددية (<code>Numeric</code>) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة.  إن كان arg من النوع <code>String</code> ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع ا<code>String#to_i</code>.  تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع <code>to_int</code> ، ثم استدعاء <code>to_i</code>. في حال تمرير <code>nil</code> فسيُطلق خطأ <code>TypeError</code>.
* التابع <code>[[Ruby/Kernel/Array|Array]]</code>: يعيد المعامل المعطى على شكل مصفوفة (<code>[[Ruby/Array|Array]]</code>).
* التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول arg إلى عدد صحيح (<code>Integer</code>). تُحوّل الأنواع العددية (<code>Numeric</code>) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة.  إن كان arg من النوع <code>String</code> ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع ا<code>String#to_i</code>.  تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع <code>to_int</code> ، ثم استدعاء <code>to_i</code>. في حال تمرير <code>nil</code> فسيُطلق خطأ <code>TypeError</code>.
* التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول المعامل المعطى إلى [[Ruby/Hash|جدول Hash]].


==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-Integer قسم التابع Integer‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]
*[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.

مصادر