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

مراجعة 15:30، 27 مايو 2018

تعيد الدالة indexOf()‎ فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

البنية العامة

يمكن استدعاء الدالة 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

يمكن استدعاء الدالة indexOf()‎ عبر المجموعات:

fun <T> Iterable<T>.indexOf(element: T): Int

يمكن استدعاء الدالة indexOf()‎ عبر اللوائح:

fun <T> List<T>.indexOf(element: T): Int

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

فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

أمثلة

استخدام الدالة`indexOf()‎` على مصفوفة: الحالة الأولى

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()indexOf للحصول على فهرس أول ظهور للعدد 4، ثم تطبع الناتج:

fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)

    print(array.indexOf(4)) // 3 
}

استخدام الدالة`indexOf()‎` على مصفوفة: الحالة الثانية

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()indexOf للحصول على فهرس أول ظهور للعدد 4، ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة ()getOrNull القيمة ‎-1‎‎:

fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)

    print(array.indexOf(14)) // -1
}

انظر أيضًا

indexOfFirst()‎: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة indexOf()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>indexOf()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</code> إن كان الفهرس خارج الحدود.
+تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
 == البنية العامة ==
 يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-fun <T> Array<out T>.getOrNull(index: Int): T?
+fun <T> Array<out T>.indexOf(element: T): Int
-fun ByteArray.getOrNull(index: Int): Byte?
+fun ByteArray.indexOf(element: Byte): Int
-fun ShortArray.getOrNull(index: Int): Short?
+fun ShortArray.indexOf(element: Short): Int
-fun IntArray.getOrNull(index: Int): Int?
+fun IntArray.indexOf(element: Int): Int
-fun LongArray.getOrNull(index: Int): Long?
+fun LongArray.indexOf(element: Long): Int
-fun FloatArray.getOrNull(index: Int): Float?
+fun FloatArray.indexOf(element: Float): Int
-fun DoubleArray.getOrNull(index: Int): Double?
+fun DoubleArray.indexOf(element: Double): Int
-fun BooleanArray.getOrNull(index: Int): Boolean?
+fun BooleanArray.indexOf(element: Boolean): Int
-fun CharArray.getOrNull(index: Int): Char?
+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">
+</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/collections|اللوائح]]:<syntaxhighlight lang="kotlin">
-fun <T> List<T>.getOrNull(index: Int): T?
+fun <T> List<T>.indexOf(element: T): Int
 </syntaxhighlight>
 == القيم المعادة ==
-قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</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>2</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور للعدد <code>4</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val array = arrayOf(1,2,3,4,5,6)
-     print(array.getOrNull(2)) // 3
+     print(array.indexOf(4)) // 3
 }
 </syntaxhighlight>
 === استخدام الدالة<code>indexOf()‎</code> على مصفوفة: الحالة الثانية ===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على قيمة العنصر عند الفهرس <code>8</code>، ولما كان هذا الفهرس خارج الحدود، فستعيد الدالة <code>()getOrNull</code>  القيمة المعدومة <code>null</code>:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <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">
 fun main(args: Array<String>) {
      val array = arrayOf(1,2,3,4,5,6)
-     print(array.getOrNull(8)) // null
+     print(array.indexOf(14)) // -1
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/collections/getOrElse|getOrElse]]()‎</code>: تعيد قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة  <code>defaultValue</code> إن كان الفهرس خارج الحدود. ان استُدعيت الدالة عبر قاموس فستُعيد القيمة المقابلة للمفتاح <code>key</code> المُمرّر إلى الدالة، أو نتيجة استدعاء الدالة المُمرّرة  <code>defaultValue</code> إن كان المفتاح<code>key</code> موجودًا.
+* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/get-or-null.html الدالة indexOf()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html الدالة indexOf()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]