الفرق بين المراجعتين ل"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.

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