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