الدالة indexOfFirst()‎ في Kotlin

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

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

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

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

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

inline fun <T> List<T>.indexOfFirst(
    predicate: (T) -> Boolean
): Int

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

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

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

أمثلة

استخدام الدالة indexOfFirst()‎ مع عنصر متطابق

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

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.indexOfFirst { it > 2 }) // 2
}

استخدام الدالةindexOfFirst()‎ مع عنصر غير متطابق

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

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.indexOfFirst { it < 0 }) // -1
}

انظر أيضًا

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

مصادر

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