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

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

تجلب الدالة indexOfLast()‎ فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

البنية العامة

يمكن استدعاء الدالة indexOfLast()‎ مع المصفوفات والمجموعات والقوائم:

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

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

`predicate`

دالةٌ تمثل الشرط الذي سيطبَّق على كل عنصر من عناصر المصفوفة أو المجموعة أو القائمة المعطاة، إذ يمرر إليها العنصر ثم تعيد قيمة منطقية مقابلة له.

القيم المعادة

يُعاد فهرس آخر عنصر حقَّق الشرط المنطقي predicate المعطى في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()indexOfLast لجلب فهرس آخر عنصر أكبر من العدد 2 وأصغر من الصفر:

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
}

انظر أيضًا

الدالة indexOf()‎: تجلب فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

الدالة indexOfFirst()‎: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
التابع Array.get()‎: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
الخاصية ‎‎lastIndex: تجلب الفهرس الأخير لمصفوفة أو قائمة.

مصادر

الدالة indexOfLast()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة indexOfLast()‎ في Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>indexOfLast()‎</code> في Kotlin}}</noinclude>
 تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
 ==البنية العامة==
@@ سطر 39: / سطر 39: @@
 ): 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 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.
 ==أمثلة==
-===استخدام الدالة<code>indexOfLast()‎</code> مع عنصر متطابق===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()indexOfLast</code> لجلب فهرس آخر عنصر أكبر من العدد 2 وأصغر من الصفر:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <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
-}
-</syntaxhighlight>
-===استخدام الدالة<code>indexOfLast()‎</code> مع عنصر غير متطابق ===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()indexOfLast</code> لجلب فهرس آخر عنصر سالب:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val array = arrayOf(1, 2, 3, 4, 5, 6)
      print(array.indexOfLast { it < 0 }) // -1
 }
@@ سطر 62: / سطر 60: @@
 *الدالة <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>: تجلب الفهرس الأخير لمصفوفة أو قائمة.
-*التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
 ==مصادر==
 * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-last.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]