Kotlin/collections/indexOf

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

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

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

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

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

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

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

يعاد فهرس أول ظهور للعنصر المعطى والموجود في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة ‎-1 إن لم يعثر على العنصر.

أمثلة

استخدام الدالة indexOf()‎ مع مصفوفة: حالة عنصر موجود

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()indexOf  لجلب فهرس العنصر "خالد" إن وجد:

fun main(args: Array<String>) {
    val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")

    print(array.indexOf("خالد"‎)) // 2
}

استخدام الدالة indexOf()‎ مع مصفوفة: حالة عنصر غير موجود

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf، ثم تستخدم الدالة  ()indexOf لجلب فهرس العنصر "احمد" إن وجد (انتبه إلى استعمال الألف عوضًا عن الهمزة):

fun main(args: Array<String>) {
    val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")

    print(array.indexOf("احمد"‎)) // -1
}

انظر أيضًا

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

مصادر

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