الفرق بين المراجعتين لصفحة: «Kotlin/collections/indexOf»

من موسوعة حسوب
طلا ملخص تعديل
ط استبدال النص - 'Kotlin Methods' ب'Kotlin Function'
سطر 45: سطر 45:
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html صفحة الدالة indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>indexOf()‎</code> في Kotlin}}</noinclude>
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html صفحة الدالة indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>indexOf()‎</code> في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]

مراجعة 11:34، 30 أغسطس 2018

تجلب الدالة 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
}

انظر أيضًا

مصادر