Kotlin/collections/indexOfFirst

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

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

يمكن استدعاء الدالة 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

يمكن استدعاء الدالة indexOfFirst()‎ عبر المجموعات:

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

يمكن استدعاء الدالة indexOfFirst()‎ عبر اللوائح:

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

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

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

فهرس أول ظهور للعنصر المُمرّر إلى الدالة indexOfFirst()‎ في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر 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  للحصول على فهرس أول ظهور لعدد أكبر من 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‎ إن كان العنصر المُمرّر غير موجود.

مصادر

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