عرض مصدر Kotlin/collections/indexOfLast

<noinclude>{{DISPLAYTITLE: الدالة <code>indexOfLast()‎</code> في Kotlin}}</noinclude>
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
==البنية العامة==
يمكن استدعاء  الدالة <code>indexOfLast()‎</code> مع المصفوفات والمجموعات والقوائم:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.indexOfLast(
    predicate: (T) -> Boolean
): Int 
inline fun ByteArray.indexOfLast(
    predicate: (Byte) -> Boolean
): Int
inline fun ShortArray.indexOfLast(
    predicate: (Short) -> Boolean
): Int 
inline fun IntArray.indexOfLast(
    predicate: (Int) -> Boolean
): Int 
inline fun LongArray.indexOfLast(
    predicate: (Long) -> Boolean
): Int 
inline fun FloatArray.indexOfLast(
    predicate: (Float) -> Boolean
): Int 
inline fun DoubleArray.indexOfLast(
    predicate: (Double) -> Boolean
): Int 
inline fun BooleanArray.indexOfLast(
    predicate: (Boolean) -> Boolean
): Int 
inline fun CharArray.indexOfLast(
    predicate: (Char) -> Boolean
): Int 

inline fun <T> Iterable<T>.indexOfLast(
    predicate: (T) -> Boolean
): Int

inline fun <T> List<T>.indexOfLast(
    predicate: (T) -> Boolean
): Int
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>predicate</code> ===
دالةٌ تمثل الشرط الذي سيطبَّق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/List|القائمة]] المعطاة، إذ يمرر إليها العنصر ثم تعيد قيمة منطقية مقابلة له.

==القيم المعادة==
يُعاد فهرس آخر عنصر حقَّق الشرط المنطقي <code>predicate</code> المعطى في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.
==أمثلة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()indexOfLast</code> لجلب فهرس آخر عنصر أكبر من العدد 2 وأصغر من الصفر:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.indexOfLast { it > 2 }) // 5
    print(array.indexOfLast { it < 0 }) // -1
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لعنصر محدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.

*الدالة <code>[[Kotlin/collections/indexOfFirst|indexOfFirst()‎]]</code>: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
*التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
*الخاصية <code>‎‎[[Kotlin/collections/lastIndex|lastIndex]]</code>: تجلب الفهرس الأخير لمصفوفة أو قائمة.
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-last.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]