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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة indexOfFirst()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور...'
 
طلا ملخص تعديل
 
(9 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة indexOfFirst()‎ في لغة Kotlin}}</noinclude>
تجلب الدالة <code>indexOfFirst()‎</code> فهرس أول عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/List|القائمة]] التي استُدعيت معها.
تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
==البنية العامة==
== البنية العامة ==
يمكن استدعاء  الدالة <code>indexOfFirst()‎</code> مع المصفوفات والمجموعات والقوائم:<syntaxhighlight lang="kotlin">
يمكن استدعاء  الدالة <code>indexOfFirst()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.indexOfFirst(
fun <T> Array<out T>.indexOf(element: T): Int  
    predicate: (T) -> Boolean
fun ByteArray.indexOf(element: Byte): Int  
): Int  
fun ShortArray.indexOf(element: Short): Int  
inline fun ByteArray.indexOfFirst(
fun IntArray.indexOf(element: Int): Int  
    predicate: (Byte) -> Boolean
fun LongArray.indexOf(element: Long): Int  
): Int  
fun FloatArray.indexOf(element: Float): Int  
inline fun ShortArray.indexOfFirst(
fun DoubleArray.indexOf(element: Double): Int  
    predicate: (Short) -> Boolean
fun BooleanArray.indexOf(element: Boolean): Int  
): Int  
fun CharArray.indexOf(element: Char): Int
inline fun IntArray.indexOfFirst(
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfFirst()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
    predicate: (Int) -> Boolean
fun <T> Iterable<T>.indexOf(element: T): Int  
): Int  
inline fun LongArray.indexOfFirst(
    predicate: (Long) -> Boolean
): Int  
inline fun FloatArray.indexOfFirst(
    predicate: (Float) -> Boolean
): Int  
inline fun DoubleArray.indexOfFirst(
    predicate: (Double) -> Boolean
): Int  
inline fun BooleanArray.indexOfFirst(
    predicate: (Boolean) -> Boolean
): Int  
inline fun CharArray.indexOfFirst(
    predicate: (Char) -> Boolean
): Int


</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfFirst()‎</code> عبر [[Kotlin/collections|اللوائح]]:<syntaxhighlight lang="kotlin">
inline fun <T> Iterable<T>.indexOfFirst(
fun <T> List<T>.indexOf(element: T): Int  
    predicate: (T) -> Boolean
</syntaxhighlight>
): Int


== القيم المعادة ==
inline fun <T> List<T>.indexOfFirst(
فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
    predicate: (T) -> Boolean
== أمثلة ==
): Int
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).


=== استخدام الدالة<code>indexOfFirst()‎</code> على مصفوفة: الحالة الأولى ===
== المعاملات ==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOfFirst</code>  للحصول على فهرس أول ظهور للعدد <code>4</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)


    print(array.indexOf(4)) // 3
=== <code>predicate</code> ===
}
دالةٌ تمثل الشرط الذي سيطبَّق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/List|القائمة]] المعطاة، إذ يمرر إليها العنصر ثم تعيد قيمة منطقية مقابلة له.
</syntaxhighlight>


=== استخدام الدالة<code>indexOfFirst()‎</code> على مصفوفة: الحالة الثانية ===
==القيم المعادة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOfFirst</code>  للحصول على فهرس أول ظهور للعدد <code>4</code>، <nowiki/>ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة <code>()getOrNull</code>  القيمة ‎<code>-1‎‎</code>:<syntaxhighlight lang="kotlin">
يُعاد فهرس أول عنصر حقَّق الشرط المنطقي <code>predicate</code> المعطى في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.
==أمثلة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()indexOfFirst</code> لجلب فهرس أول عنصر أكبر من العدد 2 وأصغر من الصفر:<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(1, 2, 3, 4, 5, 6)


     print(array.indexOf(14)) // -1
     print(array.indexOfFirst { it > 2 }) // 2
    print(array.indexOfFirst { it < 0 }) // -1
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
==انظر أيضًا==
* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
*الدالة <code>[[Kotlin/collections/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لعنصر محدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
 
*الدالة <code>[[Kotlin/collections/indexOfLast|indexOfLast()‎]]</code>: تجلب فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
== مصادر ==
*التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html الدالة indexOfFirst()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
*الدالة <code>[[Kotlin/collections/sliceArray|sliceArray()]]</code>‎ : تقطع جزءًا محدَّدًا من [[Kotlin/Array|المصفوفة]] التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها.
*الخاصية <code>‎‎[[Kotlin/collections/lastIndex|lastIndex]]</code>: تجلب الفهرس الأخير لمصفوفة أو قائمة.
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-first.html صفحة الدالة indexOfFirst()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>indexOfFirst()‎</code> في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:17، 8 سبتمبر 2018

تجلب الدالة indexOfFirst()‎ فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

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

يمكن استدعاء الدالة indexOfFirst()‎ مع المصفوفات والمجموعات والقوائم:

inline fun <T> Array<out T>.indexOfFirst(
    predicate: (T) -> Boolean
): Int 
inline fun ByteArray.indexOfFirst(
    predicate: (Byte) -> Boolean
): Int 
inline fun ShortArray.indexOfFirst(
    predicate: (Short) -> Boolean
): Int 
inline fun IntArray.indexOfFirst(
    predicate: (Int) -> Boolean
): Int 
inline fun LongArray.indexOfFirst(
    predicate: (Long) -> Boolean
): Int 
inline fun FloatArray.indexOfFirst(
    predicate: (Float) -> Boolean
): Int 
inline fun DoubleArray.indexOfFirst(
    predicate: (Double) -> Boolean
): Int 
inline fun BooleanArray.indexOfFirst(
    predicate: (Boolean) -> Boolean
): Int 
inline fun CharArray.indexOfFirst(
    predicate: (Char) -> Boolean
): Int

inline fun <T> Iterable<T>.indexOfFirst(
    predicate: (T) -> Boolean
): Int

inline fun <T> List<T>.indexOfFirst(
    predicate: (T) -> Boolean
): Int

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

predicate

دالةٌ تمثل الشرط الذي سيطبَّق على كل عنصر من عناصر المصفوفة أو المجموعة أو القائمة المعطاة، إذ يمرر إليها العنصر ثم تعيد قيمة منطقية مقابلة له.

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

يُعاد فهرس أول عنصر حقَّق الشرط المنطقي predicate المعطى في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()indexOfFirst لجلب فهرس أول عنصر أكبر من العدد 2 وأصغر من الصفر:

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

    print(array.indexOfFirst { it > 2 }) // 2
    print(array.indexOfFirst { it < 0 }) // -1
}

انظر أيضًا

مصادر

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