الدالة indexOf()
في Kotlin
< Kotlin | collections
تجلب الدالة 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
}
انظر أيضًا
- الدالة
lastIndexOf()
: تجلب فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - الدالة
indexOfFirst()
: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - الدالة
indexOfLast()
: تجلب فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - الخاصية
indices
: تجلب الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). - التابع
Array.get()
: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.