الدالة 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إن كان العنصر المُمرّر غير موجود.