التابع String.upto في روبي
يعيد التابع upto القيم المتعاقبة، ابتداءًا من السلسلة النصية str المُعطاة، وانتهاءًا بالسلسلة المُمرَّرة إليه، ثم تُمرَّر كل قيمة بدورها إلى الكتلة المعطاة. تُستخدَم طريقة التابع succ من أجل توليد القيم المتعاقبة. تُعاد القيمة الأخيرة مع مجموعة القيم المتعاقبة إذا كان المعامل الاختياري الأخير محذوفًا، أو كانت قيمته تساوي false، وتُحذف إذا كانت قيمة المعامل تساوي true.
إذا كانت السلسلة النصية المعطاة والسلسلة النصية المُمرَّرة إلى التابع عبارة فقط عن حروف عددية مُرمزة بترميز ascii؛ فإن التابع بعتبرها أعدادًا عشريةً، ويتعامل معها بالشكل المناسب (كالأصفار البادئة على سبيل المثال).
البنية العامة
upto(other_str, exclusive=false) {|s| block } → str
upto(other_str, exclusive=false) → an_enumerator
المعاملات
other_str
سلسلة نصية ينتهي عندها تسلسل القيم المتعاقبة.
exclusive
قيمة منطقة تحدد إذا ما كان على التابع حذف القيمة الأخيرة من بين مجموعة القيم المتعاقبة. القيمة الافتراضية هي: false.
القيمة المعادة
يعاد
أمثلة
مثال على استعمال التابع upto:
"a8".upto("b6") {|s| print s, ' ' }
for s in "a8".."b6"
print s, ' '
end
ييعطي عند تنفيذ هذا المثال الناتج التالي:
a8 a9 b0 b1 b2 b3 b4 b5 b6
a8 a9 b0 b1 b2 b3 b4 b5 b6
مثال آخر على استعمال التابع upto مع سلاسل نصية عددية:
"9".upto("11").to_a #=> ["9", "10", "11"]
"25".upto("5").to_a #=> []
"07".upto("11").to_a #=> ["07", "08", "09", "10", "11"]
انظر أيضًا
- التابع
succ: يعيد السلسلة التي تلي السلسلة النصية التي استدعيت معه.