Ruby/Array/index

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

في حال عدم تمرير أي شيء إلى التابع index، سيعيد‎ كائنًا من النوع Enumerator.

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

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

المعاملات

obj

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

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

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

أمثلة

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

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

انظر أيضًا

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

مصادر

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