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

يجلب التابع take_while العناصر الأولى التي تحقق الكتلة المعطاة من الكائن القابل للتعداد الذي استدعي معه.

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

take_while { |obj| block } → array
take_while → an_enumerator

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

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

أمثلة

مثال على استعمال التابع take_while:

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

انظر أيضًا

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

• التابع find_all: يعيد مصفوفة تحوي جميع العناصر المحققة للكتلة المعطاة (أي التي تعيدها معها قيمة صحيحة [true value]) من عناصر الكائن القابل للتعداد الذي استدعي معه.

• التابع take: يعيد أول عدة عناصر من الكائن القابل للتعداد الذي استدعي معه.

مصادر

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