الفرق بين المراجعتين ل"Kotlin/collections/lastIndex"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
 
سطر 18: سطر 18:
  
 
== القيم المعادة ==
 
== القيم المعادة ==
الفهرس الأخير للمصفوفة أو القائمة، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغة.
+
يعاد الفهرس الأخير للمصفوفة أو القائمة، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغة.
  
 
== أمثلة ==
 
== أمثلة ==
 
+
استخدام الخاصية <code>lastIndex‎</code> مع مصفوفة من الأعداد الصحيحة:<syntaxhighlight lang="kotlin">
=== استخدام الخاصية <code>lastIndex‎</code> مع مصفوفة من الأعداد الصحيحة ===
 
تستخدِم الشيفرة الآتية الخاصيّة <code>lastIndex‎</code> للحصول على قيمة الفهرس الأخير للمصفوفة باسم <code>array</code> والتي أُنشئِت عبر الدالة <code>arrayOf</code> وتتكون من أربعة أعدادٍ صحيحة:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val array = arrayOf(4,5,7,9)
 
     val array = arrayOf(4,5,7,9)
 
     println(array.lastIndex) // 3
 
     println(array.lastIndex) // 3
 
}
 
}
</syntaxhighlight>
+
</syntaxhighlight>استخدام الخاصية <code>lastIndex‎</code> مع مصفوفة فارغة:<syntaxhighlight lang="kotlin">
 
 
=== استخدام الخاصية <code>lastIndex‎</code> بمصفوفة فارغة ===
 
سينتج عن تنفيذ الشيفرة الآتية إنشاء مصفوفة أعدادٍ صحيحةٍ فارغةٍ باسم <code>emptyArray</code>، وعند استخدام الخاصيّة <code>lastIndex</code> لهذه المصفوفة سنحصل على النتيجة ‎<code>-1</code> لأنها لا تحتوي على أيّة عناصر، كما يلي:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val emptyArray = emptyArray<Int>()
 
     val emptyArray = emptyArray<Int>()
 
     println(emptyArray.lastIndex) // -1
 
     println(emptyArray.lastIndex) // -1
 
}
 
}
</syntaxhighlight>
+
</syntaxhighlight>جلب العنصر الأخير في القائمة (list) من خلال استعمال الخاصية <code>lastIndex</code>:<syntaxhighlight lang="kotlin">
 
 
=== الحصول على العنصر الأخير في القائمة (list) من خلال الخاصية <code>lastIndex</code> ===
 
تُنشِئ الشيفرة الآتية قائمةً من ثلاثة محارف باسم <code>list</code> وذلك بالاستفادة من الدالة <code>listOf</code> وتطبع العنصر الأخير فيها باستخدام الخاصية <code>lastIndex</code> والذي هو العنصر ذو القيمة <code>y</code>:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val list = listOf("a", "x", "y")
 
     val list = listOf("a", "x", "y")
سطر 56: سطر 48:
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Property]]
 
[[تصنيف:Kotlin Property]]
 +
[[تصنيف:Kotlin collection]]

المراجعة الحالية بتاريخ 06:48، 8 سبتمبر 2018

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

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

استخدام الخاصية lastIndex‎ مع مصفوفة فارغة:

fun main(args: Array<String>) {
    val emptyArray = emptyArray<Int>()
    println(emptyArray.lastIndex) // -1
}

جلب العنصر الأخير في القائمة (list) من خلال استعمال الخاصية lastIndex:

fun main(args: Array<String>) {
    val list = listOf("a", "x", "y")
    println(list[list.lastIndex]) // y
}

انظر أيضًا

  • الخاصيّة Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
  • الخاصيّة indices: تعبِّر عن مجال الفهارس للمصفوفة أو المجموعة (collection).

مصادر