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

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).

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

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

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

وكذلك للمجموعة (collection)

val Collection<*>.indices: IntRange

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

الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).

أمثلة

استخدام الخاصية indices‎ مع المصفوفات (Arrays)

تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf، ثم تستدعي الخاصيّة indices‎ لهذه المصفوفة لطباعة فهارسها (indices):

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

استخدام الخاصية indices‎ مع مصفوفة فارغة (Empty Array)

تُنشِئ الشيفرة الآتية مصفوفةً فارغةً باسم empty بالاعتماد على الدالة arrayOf، ثم تستدعي الخاصيّة indices‎ لهذه المصفوفة لطباعة فهارسها (indices)، وستظهر النتيجة ‎0..-1 لأنَّ المصفوفة فارغة:

fun main(args: Array<String>) {
    val empty: Array<Int> = arrayOf()
    println(empty.indices) // 0..-1
}

استخدام الخاصية indices‎ مع المجموعات (Collections)

تُنشِئ الشيفرة الآتية مجموعةً تتألف من ثلاثة محارف (characters) بالاعتماد على الدالة listOf، ثم تستدعي الخاصيّة indices لهذه المجموعة لطباعة فهارسها (indices):

fun main(args: Array<String>) {
    val collection = listOf('a', 'b', 'c')
    println(collection.indices) // 0..2
}

انظر أيضًا

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

• الخاصيّة lastIndex: تعيد فهرس العنصر الأخير في المصفوفة.

مصادر

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