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

يجلب التابع find_index فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.

في حال عدم تمرير أي وسيط أو كتلة برمجية إلى التابع find_index، فسيعيد كائنًا من النوع Enumerator.

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

 find_index(obj) → int or nil
find_index { |item| block } → int or nil
find_index → Enumerator

المعاملات

obj

الكائن المراد جلب فهرسه من المصفوفة المعطاة.

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

يعاد عددٌ صحيح يمثِّل فهرس أول ظهور للعنصر obj من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة block، أو تعاد القيمة nil إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع Enumerator إن لم يعطَ الوسيط obj أو الوسيط block.

أمثلة

أمثلة على استخدام التابع find_index:

 a = [ "a", "b", "c" ]
a.find_index("b")              #=> 1
a.find_index("z")              #=> nil
a.find_index { |x| x == "b" }  #=> 1

انظر أيضًا

• التابع index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا.
• التابع at: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه.
• التابع each_index: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها.

مصادر

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