عرض مصدر Ruby/Array/keep if

<noinclude>{{DISPLAYTITLE: التابع <code>Array.keep_if</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يٌبقِي التابع <code>keep_if</code> على جميع عناصر المصفوفة التي تحقق شرطًا معينًا ويحذف العناصر الأخرى المتبقية.

إن لم تمرَّر كتلة برمجية، فسيعيد التابع <code>keep_if</code> كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby"> keep_if { |item| block } → ary
keep_if → Enumerator


 </syntaxhighlight>
==القيم المعادة==
تعاد المصفوفة نفسها المعطاة بعد إزالة جميع العناصر الغير محققة للشرط الذي تحدده الكتلة <code>block</code>، أو يعاد كائن من النوع  إن [[Ruby/Enumerator|<code>Enumerator</code>]] إن لم تعطَ الكتلة <code>block</code>.
==أمثلة==
مثالٌ على استخدام التابع <code>keep_if</code>:
<syntaxhighlight lang="ruby"> a = %w{ a b c d e f }
a.keep_if { |v| v =~ /[aeiou]/ }  #=> ["a", "e"]
 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/delete_if | <code>delete_if</code>]]:يحذف جميع عناصر المصفوفة التي تعيد الكتلة البرمجية المعطاة القيمة <code>true</code> عند تطبيقها على كل عنصر منها.
* التابع [[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر.
* التابع<nowiki/>[[Ruby/Array/reject! | <code>reject!</code>]]<code>‎</code>: يحذف جميع عناصر المصفوفة التي لم تحقق شرطًا محددًا.
* التابع [[Ruby/Array/slice! | <code>slice</code>!‎]]: يقتطع‎ عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-keep_if قسم التابع keep_if في الصنف Array في توثيق روبي الرسمي.]