الدالة takeWhile()‎ في لغة Kotlin

تعيد الدالةtakeWhile()‎ لائحة تضم أولى عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate.

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

inline fun <T> Array<out T>.takeWhile(
    predicate: (T) -> Boolean
): List<T> 
inline fun ByteArray.takeWhile(
    predicate: (Byte) -> Boolean
): List<Byte> 
inline fun ShortArray.takeWhile(
    predicate: (Short) -> Boolean
): List<Short> 
inline fun IntArray.takeWhile(
    predicate: (Int) -> Boolean
): List<Int> 
inline fun LongArray.takeWhile(
    predicate: (Long) -> Boolean
): List<Long> 
inline fun FloatArray.takeWhile(
    predicate: (Float) -> Boolean
): List<Float> 
inline fun DoubleArray.takeWhile(
    predicate: (Double) -> Boolean
): List<Double> 
inline fun BooleanArray.takeWhile(
    predicate: (Boolean) -> Boolean
): List<Boolean> 
inline fun CharArray.takeWhile(
    predicate: (Char) -> Boolean
): List<Char> 
inline fun <T> Iterable<T>.takeWhile(
    predicate: (T) -> Boolean
): List<T>

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

لائحة تضم أولى عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate.

أمثلة

استخدام الدالة ()takeWhile مع المصفوفات

تعرّف الشيفرة الآتية  مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()takeWhile  على array مع تمرير دالة منطقية كوسيط، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(3, 5, 7, 2 , 6, 9)
    
println(array.takeWhile { it > 2 } ) // [3, 5, 7]
}

أنظر أيضًا

• take()‎ : تعيد لائحة تضم n من أولى العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
•  takeLast()‎ :تعيد لائحة تضم آخر n من العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
•  takeLastWhile()‎ : تعيد لائحة تضم آخر عناصر المصفوفة أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate. 

مصادر

• الدالة  takeWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.