عرض مصدر Ruby/Array/select!

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

قد لا تتغير المصفوفة مباشرةً في كل مرة تُستدعى فيها الكتلة البرمجية الممررة إلى هذا التابع، وستعاد القيمة <code>nil</code> إن لم يجرى أي تعديل على المصفوفة.

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