التابع Enumerable.find_all في روبي

يعيد التابع find_all مصفوفة تحوي جميع العناصر المحققة للكتلة المعطاة (أي التي تعيدها معها قيمة صحيحة [true value]) من عناصر الكائن القابل للتعداد الذي استدعي معه.

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

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

find_all { |obj| block } → array
find_all → an_enumerator

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

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

أمثلة

مثال على استعمال التابع find_all:

(1..10).find_all { |i|  i % 3 == 0 }   #=> [3, 6, 9]

[1,2,3,4,5].select { |num|  num.even?  }   #=> [2, 4]

انظر أيضًا

• التابع find: يمرِّر كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه إلى الكتلة المعطاة ثم يعيد أول عنصر محقق لها (لا تعيد معه القيمة false).

• التابع find_index: يوازن كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه مع قيمة محدَّدة ثم يعيد فهرس أول قيمة مطابقة، أو يمرِّر تلك العناصر إلى الكتلة المعطاة ويعيد فهرس أول عنصر محقق لها (لا تعيد معه القيمة false).

مصادر

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