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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة indexOf()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOf()‎</code> قيمة العنصر عند الف...'
 
طلا ملخص تعديل
 
(7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة indexOf()‎ في لغة Kotlin}}</noinclude>
تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لعنصر محدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
تعيد الدالة <code>indexOf()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</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>.getOrNull(index: Int): T?
fun ByteArray.indexOf(element: Byte): Int
fun ByteArray.getOrNull(index: Int): Byte?
fun ShortArray.indexOf(element: Short): Int
fun ShortArray.getOrNull(index: Int): Short?
fun IntArray.indexOf(element: Int): Int  
fun IntArray.getOrNull(index: Int): Int?
fun LongArray.indexOf(element: Long): Int
fun LongArray.getOrNull(index: Int): Long?
fun FloatArray.indexOf(element: Float): Int
fun FloatArray.getOrNull(index: Int): Float?
fun DoubleArray.indexOf(element: Double): Int
fun DoubleArray.getOrNull(index: Int): Double?
fun BooleanArray.indexOf(element: Boolean): Int
fun BooleanArray.getOrNull(index: Int): Boolean?
fun CharArray.indexOf(element: Char): Int
fun CharArray.getOrNull(index: Int): Char?


</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
fun <T> Iterable<T>.indexOf(element: T): Int
fun <T> List<T>.getOrNull(index: Int): T?
 
fun <T> List<T>.indexOf(element: T): Int
</syntaxhighlight>
</syntaxhighlight>
== القيم المعادة ==
==المعاملات==
قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</code> إن كان الفهرس خارج الحدود.
== أمثلة ==
 
=== استخدام الدالة<code>indexOf()‎</code> على مصفوفة: الحالة الأولى ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على قيمة العنصر عند الفهرس <code>2</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)


    print(array.getOrNull(2)) // 3
=== <code>index</code> ===
}
العنصر المراد جلب فهرس أول ظهور له.
</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">
يعاد فهرس أول ظهور للعنصر المعطى والموجود في [[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>) {
fun main(args: Array<String>) {
     val array = arrayOf(1,2,3,4,5,6)
     val array = arrayOf("محمد"‎, "عادل"‎, "خالد", ‎"أحمد")


     print(array.getOrNull(8)) // null
     print(array.indexOf("خالد"‎)) // 2
    print(array.indexOf("احمد"‎)) // -1
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
==<nowiki/>انظر أيضًا==
* <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/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|القائمة]] التي استُدعيت معها.
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/get-or-null.html الدالة indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
*الخاصية <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: الدالة <code>indexOf()‎</code> في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

مصادر

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