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

تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة، أو تعيد القيمة ‎-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 :Array<Int> = emptyArray<Int>()
  println(emptyArray.lastIndex) // -1
}

انظر أيضًا

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

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

مصادر

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