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