عرض مصدر Ruby/Enumerable/detect

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.detect</code> في روبي}}</noinclude>
يمرِّر التابع <code>detect</code> كل عنصر من عناصر [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه إلى الكتلة المعطاة ثم يعيد أول عنصر لا تعيد الكتلة معه القيمة <code>false</code>. إن لم يتطابق أي عنصر، فسيُستدعَى التابع الذي مُرِّر إليه ويعيد قيمته.

==البنية العامة==
<syntaxhighlight lang="ruby">detect(ifnone = nil) { |obj| block } → obj or nil
detect(ifnone = nil) → an_enumerator</syntaxhighlight>

== المعاملات ==

=== <code>ifnone</code> ===
التابع المراد تنفيذه عند عدم مطابقة الكتلة لأي عنصر من عناصر المُعدِّد المعطى. القيمة الافتراضية هي: <code>nil</code>.

==القيمة المعادة==
يعاد أول عنصر لا تعيد الكتلة معه القيمة <code>false</code> بعد تمرير عناصر المُعدِّد إليها تباعًا، أو يعاد ناتج تنفيذ التابع <code>ifnone</code> إن لم يتطابق أي عنصر، أو تعاد القيمة <code>nil</code> إن لم يُعطَ التابع <code>ifnone</code>.

== أمثلة ==
مثال على استعمال التابع <code>detect</code>:<syntaxhighlight lang="ruby">
(1..100).detect  => #<Enumerator: 1..100:detect>
(1..100).find    => #<Enumerator: 1..100:find>

(1..10).detect   { |i| i % 5 == 0 and i % 7 == 0 }   #=> nil
(1..10).find     { |i| i % 5 == 0 and i % 7 == 0 }   #=> nil
(1..100).detect  { |i| i % 5 == 0 and i % 7 == 0 }   #=> 35
(1..100).find    { |i| i % 5 == 0 and i % 7 == 0 }   #=> 35
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/collect|collect]]</code>: يعيد مصفوفة جديدة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر [[Ruby/Enumerator|المُعدِّد]] الذي استدعي معه.

*التابع <code>[[Ruby/Enumerable/drop while|drop_while]]</code>: يحذف العناصر الأولى المحقِّقة لشرط معيِّن من المُعدِّد المعطى ثم يعيد مصفوفة تحوي العناصر المتبقية.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-detect قسم التابع detect في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]