الخاصية 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.