Kotlin/collections/lastIndex

تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغةً.

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

توفّر لغة Kotlin الخاصيّة lastIndex للمصفوفات من الأنواع المختلفة كما يلي:

val <T> Array<out T>.lastIndex: IntRange
val ByteArray.lastIndex: IntRange
val ShortArray.lastIndex: IntRange
val IntArray.lastIndex: IntRange
val LongArray.lastIndex: IntRange
val FloatArray.lastIndex: IntRange
val DoubleArray.lastIndex: IntRange
val BooleanArray.lastIndex: IntRange
val CharArray.lastIndex: IntRange

وكذلك للقائمة (list):

val <T> List<T>.lastIndex: Int

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

الفهرس الأخير للمصفوفة أو القائمة، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغة.

أمثلة

استخدام الخاصية lastIndex‎ مع مصفوفة من الأعداد الصحيحة

تستخدِم الشيفرة الآتية الخاصيّة lastIndex‎ للحصول على قيمة الفهرس الأخير للمصفوفة باسم array والتي أُنشئِت عبر الدالة arrayOf وتتكون من أربعة أعدادٍ صحيحة:

fun main(args: Array<String>) {
    val array = arrayOf(4,5,7,9)
    println(array.lastIndex) // 3
}

استخدام الخاصية lastIndex‎ بمصفوفة فارغة

سينتج عن تنفيذ الشيفرة الآتية إنشاء مصفوفة أعدادٍ صحيحةٍ فارغةٍ باسم emptyArray، وعند استخدام الخاصيّة lastIndex لهذه المصفوفة سنحصل على النتيجة ‎-1 لأنها لا تحتوي على أيّة عناصر، كما يلي:

fun main(args: Array<String>) {
    val emptyArray = emptyArray<Int>()
    println(emptyArray.lastIndex) // -1
}

الحصول على العنصر الأخير في القائمة (list) من خلال الخاصية lastIndex

تُنشِئ الشيفرة الآتية قائمةً من ثلاثة محارف باسم list وذلك بالاستفادة من الدالة listOf وتطبع العنصر الأخير فيها باستخدام الخاصية lastIndex والذي هو العنصر ذو القيمة y:

fun main(args: Array<String>) {
    val list = listOf("a", "x", "y")
    println(list[list.lastIndex]) // y
}

انظر أيضًا

• الخاصيّة Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.

• الخاصيّة indices: تعبِّر عن مجال الفهارس للمصفوفة أو المجموعة (collection).

مصادر

• صفحة الخاصيّة lastIndex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.