الدالة dropLastWhile()‎ في Kotlin

تعيد الدالة dropLastWhile()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.

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

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

المعاملات

predicate

دالةٌ تمثل الشرط الذي سيُطبق على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة.

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

تُعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء العناصر الأخيرة التي تعيد القيمة true عند تطبيق الدالة predicate المُمرّرة عليها.

أمثلة

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

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تعرف الدالة predicate المنطقية لاستعمالها مع الدالة ()dropLastWhile لحذف العناصر الأخيرة التي تزيد قيمتها عن 3:

fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)
    val predicate: (Int) -> Boolean = { it > 3}
    println(array.dropLastWhile(predicate)) // [1, 2, 3]
}

انظر أيضًا

• الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.
• الدالة dropLast()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.
• الدالة dropWhile()‎: تعيد قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
• الدالة distinctBy()‎: تعيد قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق دالة معينة عليها فقط.
• الدالة elementAt()‎: تعيد العنصر الموجود عند فهرس معين في المصفوفة أو المجموعة التي استُدعيت معها.

مصادر

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