التابع Enumerator.size في روبي

يكرِّر التابع with_index الكتلة المعطاة على كل عنصر من عناصر المُعدِّد الذي استدعي معه مع فهارسها والتي تبدأ عند موضع محدَّد. إن لم تُعطَ الكتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator يحوي تلك الفهارس.

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

with_index(offset = 0) {|(*args), idx| ... }
with_index(offset = 0)

المعاملات

offset

عدد صحيح يحدِّد فهرس العنصر المراد بدء عملية التكرار عنده. القيمة الافتراضية هي: 0.

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

يعاد الناتج الذي تعيده الكتلة بعد تكرارها على كل عنصر من عناصر المُعدِّد المعطى مع فهارسها والتي تبدأ عند الموضع offset، أو يعاد كائن من النوع Enumerator إن لم تُعطَ الكتلة.

انظر أيضًا

• التابع each_with_index: يشبه التابع with_index باستثناء أنه لا يوجد إزاحة بادئة لبدء العملية عند قيمة محدَّدة.

• التابع with_object: يكرر الكتلة المعطاة على كل عنصر من عناصر المُعدِّد الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن.

مصادر

• قسم التابع with_index في الصنف Enumerator في توثيق روبي الرسمي.