الفرق بين المراجعتين لصفحة: «Kotlin/collections/lastIndex»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الخاصية lastIndex في لغة Kotlin}}</noinclude> تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) ا...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الخاصية lastIndex في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الخاصية lastIndex في لغة Kotlin}}</noinclude> | ||
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة، أو تعيد القيمة -1 إن كانت المصفوفة فارغةً. | تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة، أو تعيد القيمة <code>-1</code> إن كانت المصفوفة فارغةً. | ||
== البنية العامة == | == البنية العامة == | ||
توفّر لغة Kotlin الخاصيّة lastIndex لمصفوفات الأنواع المختلفة كما يلي: | توفّر لغة Kotlin الخاصيّة <code>lastIndex</code> لمصفوفات الأنواع المختلفة كما يلي:<syntaxhighlight lang="kotlin"> | ||
val <T> Array<out T>.lastIndex: IntRange | val <T> Array<out T>.lastIndex: IntRange | ||
val ByteArray.lastIndex: IntRange | val ByteArray.lastIndex: IntRange | ||
val ShortArray.lastIndex: IntRange | val ShortArray.lastIndex: IntRange | ||
val IntArray.lastIndex: IntRange | val IntArray.lastIndex: IntRange | ||
val LongArray.lastIndex: IntRange | val LongArray.lastIndex: IntRange | ||
val FloatArray.lastIndex: IntRange | val FloatArray.lastIndex: IntRange | ||
val DoubleArray.lastIndex: IntRange | val DoubleArray.lastIndex: IntRange | ||
val BooleanArray.lastIndex: IntRange | val BooleanArray.lastIndex: IntRange | ||
val CharArray.lastIndex: IntRange | val CharArray.lastIndex: IntRange | ||
</syntaxhighlight>وكذلك للقائمة (list):<syntaxhighlight lang="kotlin"> | |||
وكذلك للقائمة (list): | |||
val <T> List<T>.lastIndex: Int | val <T> List<T>.lastIndex: Int | ||
</syntaxhighlight> | |||
== القيم المعادة == | == القيم المعادة == | ||
| سطر 32: | سطر 22: | ||
== أمثلة == | == أمثلة == | ||
=== استخدام الخاصية lastIndex بمصفوفة من الأعداد الصحيحة === | === استخدام الخاصية <code>lastIndex</code> بمصفوفة من الأعداد الصحيحة === | ||
تستخدم الشيفرة الآتية الخاصية lastIndex للحصول على قيمة الفهرس الأخير للمصفوفة باسم array والتي تتكون من أربعة عناصر من الأعداد الصحيحة، ويُلاحظ أنّ إنشاء المصفوفة يتمّ عبر الدالة arrayOf كما في الشيفرة: | تستخدم الشيفرة الآتية الخاصية <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) | |||
} | } | ||
</syntaxhighlight> | |||
=== استخدام الخاصية <code>lastIndex</code> بمصفوفة فارغة === | |||
سينتج عن تنفيذ الشيفرة الآتية إنشاء مصفوفة فارغة باسم <code>emptyArray</code> وعند استخدام الخاصية <code>lastIndex</code> لهذه المصفوفة سنحصل على النتيجة <code>-1</code> لأنها لا تحتوي على أيّة عناصر، كما يلي:<syntaxhighlight lang="kotlin"> | |||
=== استخدام الخاصية lastIndex بمصفوفة فارغة === | |||
سينتج عن تنفيذ الشيفرة الآتية إنشاء مصفوفة فارغة باسم emptyArray وعند استخدام الخاصية lastIndex لهذه المصفوفة سنحصل على النتيجة -1 لأنها لا تحتوي على أيّة عناصر، كما يلي: | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val emptyArray :Array<Int> = emptyArray<Int>() | |||
val | |||
println(emptyArray.lastIndex) // -1 | println(emptyArray.lastIndex) // -1 | ||
} | } | ||
</syntaxhighlight> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* | * الخاصية <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة. | ||
* الخاصيّة indices: تعيد مجال الفهارس للمصفوفة أو المجموعة (collection). | |||
* الخاصيّة <code>[[Kotlin/collections/indices|indices]]</code>: تعيد مجال الفهارس للمصفوفة أو المجموعة (collection). | |||
== مصادر == | == مصادر == | ||
* الخاصيّة lastIndex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin. | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/last-index.html الخاصيّة lastIndex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:kotlin properties]] | [[تصنيف:kotlin properties]] | ||
مراجعة 21:22، 9 مايو 2018
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة، أو تعيد القيمة -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 بمصفوفة من الأعداد الصحيحة
تستخدم الشيفرة الآتية الخاصية lastIndex للحصول على قيمة الفهرس الأخير للمصفوفة باسم array والتي تتكون من أربعة عناصر من الأعداد الصحيحة، ويُلاحظ أنّ إنشاء المصفوفة يتمّ عبر الدالة arrayOf كما في الشيفرة:
fun main(args: Array<String>) {
val array = arrayOf(4,5,7,9)
println(array.lastIndex) // 3
}
استخدام الخاصية lastIndex بمصفوفة فارغة
سينتج عن تنفيذ الشيفرة الآتية إنشاء مصفوفة فارغة باسم emptyArray وعند استخدام الخاصية lastIndex لهذه المصفوفة سنحصل على النتيجة -1 لأنها لا تحتوي على أيّة عناصر، كما يلي:
fun main(args: Array<String>) {
val emptyArray :Array<Int> = emptyArray<Int>()
println(emptyArray.lastIndex) // -1
}
انظر أيضًا
- الخاصية
Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
- الخاصيّة
indices: تعيد مجال الفهارس للمصفوفة أو المجموعة (collection).