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

المراجعة الحالية بتاريخ 14:08، 15 ديسمبر 2018

يعيد التابع 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: يعيد السلسلة التي تلي السلسلة النصية التي استدعيت معه.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby String]]
-يعيد التابع <code>upto</code> ب
+يعيد التابع <code>upto</code> القيم المتعاقبة، ابتداءًا من السلسلة النصية <code>str</code> المُعطاة، وانتهاءًا بالسلسلة المُمرَّرة إليه، ثم تُمرَّر كل قيمة بدورها إلى الكتلة المعطاة. تُستخدَم طريقة التابع <code>[[Ruby/String/succ|succ]]</code> من أجل توليد القيم المتعاقبة. تُعاد القيمة الأخيرة مع مجموعة القيم المتعاقبة إذا كان المعامل الاختياري الأخير محذوفًا، أو كانت قيمته تساوي <code>false</code>، وتُحذف إذا كانت قيمة المعامل تساوي <code>true</code>.
+إذا كانت السلسلة النصية المعطاة والسلسلة النصية المُمرَّرة إلى التابع عبارة فقط عن حروف عددية مُرمزة بترميز [[Arduino/asciichart|ascii]]؛ فإن التابع بعتبرها أعدادًا عشريةً، ويتعامل معها بالشكل المناسب (كالأصفار البادئة على سبيل المثال).
 ==البنية العامة==
 <syntaxhighlight lang="ruby">upto(other_str, exclusive=false) {|s| block } → str
 upto(other_str, exclusive=false) → an_enumerator</syntaxhighlight>
+== المعاملات ==
+=== <code>other_str</code> ===
+سلسلة نصية ينتهي عندها تسلسل القيم المتعاقبة.
+=== <code>exclusive</code> ===
+قيمة منطقة تحدد إذا ما كان على التابع حذف القيمة الأخيرة من بين مجموعة القيم المتعاقبة. القيمة الافتراضية هي: <code>false</code>.
 ==القيمة المعادة==
@@ سطر 16: / سطر 27: @@
 for s in "a8".."b6"
    print s, ' '
-end</syntaxhighlight>
+end</syntaxhighlight>ييعطي عند تنفيذ هذا المثال الناتج التالي:<syntaxhighlight lang="text">
+a8 a9 b0 b1 b2 b3 b4 b5 b6
+a8 a9 b0 b1 b2 b3 b4 b5 b6
+</syntaxhighlight>مثال آخر على استعمال التابع <code>upto</code> مع سلاسل نصية عددية:<syntaxhighlight lang="ruby">
+"9".upto("11").to_a   #=> ["9", "10", "11"]
+"25".upto("5").to_a   #=> []
+"07".upto("11").to_a  #=> ["07", "08", "09", "10", "11"]
+</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
+* التابع <code>[[Ruby/String/succ|succ]]</code>: يعيد السلسلة التي تلي السلسلة النصية التي استدعيت معه.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/String.html#method-i-upto قسم التابع upto‎ في الصنف String في توثيق روبي الرسمي.]