الخاصية ‎‎lastIndex في Kotlin

تُستخدَم هذه الخاصيّة للحصول على الفهرس (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‎ مع مصفوفة من الأعداد الصحيحة:

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

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

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

جلب العنصر الأخير في القائمة (list) من خلال استعمال الخاصية lastIndex:

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

انظر أيضًا

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

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

مصادر

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