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

تعيد الدالة indexOf()‎ قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو null إن كان الفهرس خارج الحدود.

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

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

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

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

fun <T> List<T>.getOrNull(index: Int): T?

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

قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو null إن كان الفهرس خارج الحدود.

أمثلة

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

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

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

    print(array.getOrNull(2)) // 3 
}

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

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

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

    print(array.getOrNull(8)) // null
}

انظر أيضًا

getOrElse()‎: تعيد قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة defaultValue إن كان الفهرس خارج الحدود. ان استُدعيت الدالة عبر قاموس فستُعيد القيمة المقابلة للمفتاح key المُمرّر إلى الدالة، أو نتيجة استدعاء الدالة المُمرّرة defaultValue إن كان المفتاحkey موجودًا.

مصادر

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