الدالة text.indexOf()‎ في لغة Kotlin

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

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

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

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

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

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

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

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

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

أمثلة

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

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

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

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

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

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

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

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

انظر أيضًا

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

مصادر

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