Kotlin/collections/takeLast

تجلب الدالة takeLast()‎ آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. 

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

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

المعاملات

n

عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد كل العناصر الموجودة في المصفوفة أو المجموعة التكرارية آنذاك.

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

تعاد قائمة تحوي آخر n من عناصر المصفوفة أو المجموعة التكرارية المعطاة.

أمثلة

استعمال الدالة ()takeLast لجلب آخر عنصرين من قائمة:

fun main(args: Array<String>) {
    val chars = ('a'..'z').toList()
    println(chars.takeLast(2)) // [y, z]
}

انظر أيضًا

• الدالة last()‎: تجلب آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
• الدالة take()‎: تجلب أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
• الدالة takeWhile()‎: تجلب أول عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
• الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
• الدالة lastIndexOf()‎: تجلب فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
• الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.

مصادر

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