Kotlin/collections/last

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

في حال كانت المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها الدالةlast()‎ فارغة أو لم يكن هناك أي عنصر يحقق الشرط المنطقي predicate فستطلق استثناءً NoSuchElementException.

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

يمكن استدعاء الدالةlast()‎ على المصفوفات:

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

يمكن تمرير وسيط predicate إلى الدالةlast()‎:

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

يمكن استدعاء الدالةlast()‎ على المجموعات:

fun <T> Iterable<T>.last(): T

يمكن استدعاء الدالةlast()‎ على اللوائح:

fun <T> List<T>.last(): T

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

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

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

أمثلة

استخدام الدالة ()last مع المصفوفات: الحالة الأولى

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تُعرّف الدالة المنطقية ()predicate التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من 3 ، ثم تستخدم الدالة ()last لإيجاد العنصر الأخير في المصفوفةarray الذي يحقق الدالة ()predicate، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(9, 2, 3, 8, 5, 6)
val predicate  : (Int) -> Boolean = { it < 3 }

println(array.last(predicate)) // 2
}

استخدام الدالة ()last مع المصفوفات: الحالة الثانية

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تُعرّف الدالة المنطقية ()predicate التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من 0 ، ثم تستخدم الدالة ()last لإيجاد العنصر الأخير في المصفوفةarray الذي يحقق الدالة ()predicate، ولمّا كانت كل عناصر array لا تحقق ذلك فستطلق استثناءً NoSuchElementException، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(9, 2, 3, 2, 5, 1)
val predicate  : (Int) -> Boolean = { it < 0 }

println(array.last(predicate)) // إطلاق استثناء
}

انظر أيضًا

• lastIndexOf()‎: تعيد آخر فهرس للعنصر الممرّر في المصفوفة أو المجموعة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد ‎-1‎.

مصادر

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