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

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

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

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

fun <T> Array<out T>.indexOf(element: T): Int 
fun ByteArray.indexOf(element: Byte): Int 
fun ShortArray.indexOf(element: Short): Int 
fun IntArray.indexOf(element: Int): Int 
fun LongArray.indexOf(element: Long): Int 
fun FloatArray.indexOf(element: Float): Int 
fun DoubleArray.indexOf(element: Double): Int 
fun BooleanArray.indexOf(element: Boolean): Int 
fun CharArray.indexOf(element: Char): Int

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

fun <T> Iterable<T>.indexOf(element: T): Int

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

fun <T> List<T>.indexOf(element: T): Int

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

فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

أمثلة

استخدام الدالة`indexOfFirst()‎` على مصفوفة: الحالة الأولى

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

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

    print(array.indexOf(4)) // 3 
}

استخدام الدالة`indexOfFirst()‎` على مصفوفة: الحالة الثانية

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()indexOfFirst للحصول على فهرس أول ظهور للعدد 4، ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة ()getOrNull القيمة ‎-1‎‎:

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

    print(array.indexOf(14)) // -1
}

انظر أيضًا

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

مصادر

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