التابع Array.each_index في روبي

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

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

 each_index { |index| block } → ary
each_index → Enumerator

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

تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block.

أمثلة

مثالٌ على استخدام التابع each_index:

 a = [ "a", "b", "c" ]
a.each_index {|x| print x, " -- " }
سيعطي هذا المثال عند تنفيذه الناتج التالي:
0 -- 1 -- 2 --

انظر أيضًا

• التابع each: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة.
• التابع find_index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.
• التابع collect: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة.

مصادر

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