الفرق بين المراجعتين ل"Kotlin/collections/indexOf"

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

مراجعة 07:04، 24 يوليو 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
}

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/collections/indexOf&oldid=13524"