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

المراجعة الحالية بتاريخ 08:16، 8 سبتمبر 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

المعاملات

`index`

العنصر المراد جلب فهرس أول ظهور له.

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

يعاد فهرس أول ظهور للعنصر المعطى والموجود في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة ‎-1 إن لم يعثر على العنصر.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()indexOf لجلب فهرس العنصر "خالد" إن وجد وفهرس العنصر "احمد" إن وجد (انتبه إلى استعمال الألف عوضًا عن الهمزة):

fun main(args: Array<String>) {
    val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")

    print(array.indexOf("خالد"‎)) // 2
    print(array.indexOf("احمد"‎)) // -1
}

انظر أيضًا

الدالة lastIndexOf()‎: تجلب فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
الدالة indexOfFirst()‎: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
الدالة indexOfLast()‎: تجلب فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
الخاصية ‎‎indices: تجلب الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
التابع Array.get()‎: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
الدالة slice()‎ : تقطع جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.

مصادر

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

@@ سطر 16: / سطر 16: @@
 fun <T> List<T>.indexOf(element: T): Int
 </syntaxhighlight>
+==المعاملات==
+=== <code>index</code> ===
+العنصر المراد جلب فهرس أول ظهور له.
 ==القيم المعادة==
 يعاد فهرس أول ظهور للعنصر المعطى والموجود في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] المعطاة، أو القيمة ‎-1 إن لم يعثر على العنصر.
 ==أمثلة==
-===استخدام الدالة <code>indexOf()‎</code> مع مصفوفة: حالة عنصر موجود===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()indexOf</code>  لجلب فهرس العنصر "خالد" إن وجد وفهرس العنصر "احمد" إن وجد (انتبه إلى استعمال الألف عوضًا عن الهمزة):<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()indexOf</code>  لجلب فهرس العنصر "خالد" إن وجد:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")
      print(array.indexOf("خالد"‎)) // 2
-}
-</syntaxhighlight>
-===استخدام الدالة <code>indexOf()‎</code> مع مصفوفة: حالة عنصر غير موجود===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code> لجلب فهرس العنصر "احمد" إن وجد (انتبه إلى استعمال الألف عوضًا عن الهمزة):<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")
      print(array.indexOf("احمد"‎)) // -1
 }
 </syntaxhighlight>
-==انظر أيضًا==
+==<nowiki/>انظر أيضًا==
+*الدالة <code>[[Kotlin/collections/lastIndexOf|lastIndexOf()‎]]</code>: تجلب فهرس آخر ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 *الدالة <code>[[Kotlin/collections/indexOfFirst|indexOfFirst()‎]]</code>: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
 *الدالة <code>[[Kotlin/collections/indexOfLast|indexOfLast()‎]]</code>: تجلب فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
 *الخاصية <code>‎‎[[Kotlin/collections/indices|indices]]</code>: تجلب الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
 *التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
+*الدالة <code>[[Kotlin/collections/slice|slice()]]</code>‎ : تقطع جزءًا محدَّدًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها ثمَّ تعيده في قائمة.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html صفحة الدالة indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة indexOf()‎ في 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 Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]