التابع Array.take_while في روبي

يجلب التابع take_while العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى. إن لم تمرَّر أية كتلة إلى التابع take_while، فسيعيد كائنًا من النوع Enumerator.

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

 take_while { |obj| block } → new_ary
take_while → Enumerator

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

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

أمثلة

مثالٌ على استخدام التابع take_while:

 a = [1, 2, 3, 4, 5, 0]
a.take_while { |i| i < 3 }  #=> [1, 2]

انظر أيضًا

• التابع take: يجلب أول n عنصر من مصفوفة.
• التابع drop_while: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر.

مصادر

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