الدالة indexOfLast() في لغة Kotlin
تعيد الدالة indexOfLast() فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر predicate، أو -1 إن لم يكن هناك أي عنصر يحقق ذلك.
البنية العامة
يمكن استدعاء الدالة indexOfLast() عبر المصفوفات:
inline fun <T> Array<out T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
inline fun ByteArray.indexOfFirst(
predicate: (Byte) -> Boolean
): Int
inline fun ShortArray.indexOfFirst(
predicate: (Short) -> Boolean
): Int
inline fun IntArray.indexOfFirst(
predicate: (Int) -> Boolean
): Int
inline fun LongArray.indexOfFirst(
predicate: (Long) -> Boolean
): Int
inline fun FloatArray.indexOfFirst(
predicate: (Float) -> Boolean
): Int
inline fun DoubleArray.indexOfFirst(
predicate: (Double) -> Boolean
): Int
inline fun BooleanArray.indexOfFirst(
predicate: (Boolean) -> Boolean
): Int
inline fun CharArray.indexOfFirst(
predicate: (Char) -> Boolean
): Int
يمكن استدعاء الدالة indexOfLast() عبر المجموعات:
inline fun <T> Iterable<T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
يمكن استدعاء الدالة indexOfLast() عبر اللوائح:
inline fun <T> List<T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر predicate، أو -1 إن لم يكن هناك أي عنصر يحقق ذلك.
أمثلة
استخدام الدالةindexOfLast() على مصفوفة: الحالة الأولى
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()indexOfLast للحصول على فهرس أول ظهور لعدد أكبر من 2، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
print(array.indexOfFirst { it > 2 }) // 2
}
استخدام الدالةindexOfLast() على مصفوفة: الحالة الثانية
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()indexOfLast للحصول على فهرس أول ظهور لعدد أكبر من 8، ولمّا كانت كل عناصر المصفوفة array أصغر من العدد 8، فستعيد الدالة ()indexOfFirst القيمة -1:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
print(array.indexOfFirst { it > 8 }) // -1
}
انظر أيضًا
indexOf(): تعيد فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو -1إن كان العنصر المُمرّر غير موجود.