الخاصية 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 مع مصفوفة من الأعداد الصحيحة
تستخدِم الشيفرة الآتية الخاصيّة 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).