الفرق بين المراجعتين لصفحة: «Kotlin/collections/indices»

مراجعة 03:51، 30 مايو 2018

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (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.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الخاصية indices في لغة Kotlin}}</noinclude>
-تُستخدَم هذه الخاصيّة للحصول على الفهارس (indices) الصحيحة للمصفوفة أو المجموعة (collection).
+تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
 == البنية العامة ==
-توفّر لغة Kotlin الخاصيّة indices لمصفوفات الأنواع المختلفة كما يلي:<syntaxhighlight lang="kotlin">
+توفّر لغة Kotlin الخاصيّة indices للمصفوفات من الأنواع المختلفة كما يلي:<syntaxhighlight lang="kotlin">
 val <T> Array<out T>.indices: IntRange
 val ByteArray.indices: IntRange
@@ سطر 13: / سطر 13: @@
 val BooleanArray.indices: IntRange
 val CharArray.indices: IntRange
-</syntaxhighlight>وكذلك المجموعة (collection)<syntaxhighlight lang="kotlin">
+</syntaxhighlight>وكذلك للمجموعة (collection)<syntaxhighlight lang="kotlin">
 val Collection<*>.indices: IntRange
 </syntaxhighlight>
 == القيم المعادة ==
-الفهارس (indices) الصحيحة للمصفوفة أو المجموعة (collection).
+الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
 == أمثلة ==
-=== استخدام الخاصية <code>indices‎</code> ===
+=== استخدام الخاصية <code>indices‎</code> مع المصفوفات (Arrays) ===
-تُنشئ الشيفرة الآتية مصفوفة من أربعة أعداد ثم تستدعي الخاصية <code>indices‎</code> عبرها للحصول على  فهارسها (indices) الصحيحة وطباعتها:<syntaxhighlight lang="kotlin">
+تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة <code>arrayOf</code>، ثم تستدعي الخاصيّة <code>indices‎</code> لهذه المصفوفة لطباعة فهارسها (indices):<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
- val array = arrayOf(4,5,7,9)
+    val array = arrayOf(4,5,7,9)
- println(array.indices) // 0..3
+    println(array.indices) // 0..3
 }
+</syntaxhighlight>
+=== استخدام الخاصية <code>indices‎</code> مع مصفوفة فارغة (Empty Array) ===
+تُنشِئ الشيفرة الآتية مصفوفةً فارغةً باسم <code>empty</code> بالاعتماد على الدالة <code>arrayOf</code>، ثم تستدعي الخاصيّة <code>indices‎</code> لهذه المصفوفة لطباعة فهارسها (indices)، وستظهر النتيجة <code>‎0..-1</code> لأنَّ المصفوفة فارغة:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val empty: Array<Int> = arrayOf()
+    println(empty.indices) // 0..-1
+}
+</syntaxhighlight>
+=== استخدام الخاصية <code>indices‎</code> مع المجموعات (Collections) ===
+تُنشِئ الشيفرة الآتية مجموعةً تتألف من ثلاثة محارف (characters) بالاعتماد على الدالة <code>listOf</code>، ثم تستدعي الخاصيّة <code>indices</code> لهذه المجموعة لطباعة فهارسها (indices):<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val collection = listOf('a', 'b', 'c')
+    println(collection.indices) // 0..2
+}
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصية <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الخاصيّة <code>[[Kotlin/Array/size|size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
-* الخاصية <code>[[Kotlin/collections/lastIndex|lastIndex]]</code>: تعيد الفهرس الأخير.
+* الخاصيّة <code>[[Kotlin/collections/lastIndex|lastIndex]]</code>: تعيد فهرس العنصر الأخير في المصفوفة.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/indices.html الخاصية indices في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/indices.html صفحة الخاصيّة indices في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]