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

من موسوعة حسوب
مراجعة + إضافة مثال
طلا ملخص تعديل
 
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الخاصية lastIndex في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الخاصية <code>‎‎lastIndex</code> في Kotlin}}</noinclude>
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎<code>-1</code> إن كانت المصفوفة أو القائمة فارغةً.
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎<code>-1</code> إن كانت المصفوفة أو القائمة فارغةً.


سطر 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).

مصادر