عرض مصدر Ruby/Enumerable/find all

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.find_all</code> في روبي}}</noinclude>
يعيد التابع <code>find_all</code> مصفوفة تحوي جميع العناصر المحققة للكتلة المعطاة (أي التي تعيدها معها قيمة صحيحة [true value]) من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.

إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">find_all { |obj| block } → array
find_all → an_enumerator</syntaxhighlight>
==القيمة المعادة==
تعاد مصفوفة تحوي جميع العناصر التي أعادت معها الكتلة <code>block</code> قيمةً صحيحةً من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] المعطى بعد تمريرها إليها، أو يعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم تُعطَ أية كتلة.
==أمثلة==
مثال على استعمال التابع <code>find_all</code>:<syntaxhighlight lang="ruby">
(1..10).find_all { |i|  i % 3 == 0 }   #=> [3, 6, 9]

[1,2,3,4,5].select { |num|  num.even?  }   #=> [2, 4]
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/find|find]]</code>: يمرِّر كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه إلى الكتلة المعطاة ثم يعيد أول عنصر محقق لها (لا تعيد معه القيمة <code>false</code>).

*التابع <code>[[Ruby/Enumerable/find index|find_index]]</code>: يوازن كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه مع قيمة محدَّدة ثم يعيد فهرس أول قيمة مطابقة، أو يمرِّر تلك العناصر إلى الكتلة المعطاة ويعيد فهرس أول عنصر محقق لها (لا تعيد معه القيمة <code>false</code>).
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-find_all قسم التابع find_all في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]