التابع String.to_i في روبي

يحول التابع to_i العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد صحيح ذي أساس محدَّد. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0 دون إطلاق أية استثناءات، بشرط أن يكون الأساس المراد تمثيل العدد به صحيحًا.

البنية العامة

to_i(base=10) → integer

المعاملات

base

عدد صحيح يمثِّل الأساس الذي يُعاد وفقه العدد الموجود في بادئة السلسلة النصية المعطاة. تتراوح قيمة هذا المعامل بين 2 و 36. القيمة الافتراضية له هي: 10.

القيمة المعادة

يُعاد العدد الصحيح المقابل لبادئة السلسلة النصية وفق الأساس base.

أمثلة

مثال على استعمال التابع to_i:

"12345".to_i             #=> 12345
"99 red balloons".to_i   #=> 99
"0a".to_i                #=> 0
"0a".to_i(16)            #=> 10
"hello".to_i             #=> 0
"1100101".to_i(2)        #=> 101
"1100101".to_i(8)        #=> 294977
"1100101".to_i(10)       #=> 1100101
"1100101".to_i(16)       #=> 17826049

انظر أيضًا

• التابع to_c: يحول السلسلة النصية التي استدعيت معه إلى عدد عقدي.

• التابع to_f: يحول الأرقام الموجودة في بداية السلسلة النصية المعطاة إلى عدد عشري.
• التابع to_r: يحول العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد جذري.
• التابع to_s: يعيد السلسلة النصية التي استدعيت معه نفسها.
• التابع to_sym: يحول السلسلة النصية التي استدعيت معه إلى رمز، إذ يُنشىء ذلك الرمز إذا لم يكن الرمز المقابل للسلسلة النصية تلك مُوجودًا مُسبقًا.

مصادر

• قسم التابع ‎to_i في الصنف String في توثيق روبي الرسمي.