التابع Range.step‎ في روبي

من موسوعة حسوب
< Ruby‏ | Range

يكرر التابع step تنفيذ الكتلة المعطاة ويمرر إليها n عنصرًا من عناصر المجال بالتتابع.

إن كان عنصرا البداية والنهاية عددين، فسيضاف n عند كل تكرار. وإلا، فإن التابع step سيستدعي succ للتكرار على عناصر المجال.

في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلاً من ذلك.

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

step(n=1) {| obj | block }  rng
step(n=1) an_enumerator

المعاملات

n‎

عدد صحيح يمثِّل الخطوة. الخطوة الافتراضية هي: 1.

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

يعاد مجالٌ، أو كائن من الصنف Enumerator في حال لم تُعطَ أي كتلة.

أمثلة

مثال على استخدام التابع step‎ (انظر صفحة Range للاطلاع على مثال تعريف الصنف Xs):

range = Xs.new(1)..Xs.new(10)
range.step(2) {|x| puts x}
puts
range.step(3) {|x| puts x}

ناتج تنفيذ هذه الشيفرة هو:

 1 x
 3 xxx
 5 xxxxx
 7 xxxxxxx
 9 xxxxxxxxx
 1 x
 4 xxxx
 7 xxxxxxx
10 xxxxxxxxxx‎

انظر أيضًا

  • التابع each: يُكرر تنفيذ الكتلة المعطاة مع تمرير عناصر المجال إليها بالتتابع.

مصادر