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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
لا ملخص تعديل
ط مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة indexOfLast()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة indexOfLast()‎ في Kotlin}}</noinclude>
تعيد الدالة <code>indexOfLast()‎</code> فهرس آخر ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
== البنية العامة ==
==البنية العامة==
يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
يمكن استدعاء  الدالة <code>indexOfLast()‎</code> مع المصفوفات والمجموعات والقوائم:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.indexOfLast(
inline fun <T> Array<out T>.indexOfLast(
     predicate: (T) -> Boolean
     predicate: (T) -> Boolean
سطر 31: سطر 31:
): Int  
): Int  


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


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


     print(array.indexOfLast { it > 8 }) // -1
     print(array.indexOfLast { it < 0 }) // -1
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
==انظر أيضًا==
* <code>[[Kotlin/collections/indexOf|indexOf]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو <nowiki/>[[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
*الدالة <code>[[Kotlin/collections/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لعنصر محدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
 
* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.


== مصادر ==
*الدالة <code>[[Kotlin/collections/indexOfFirst|indexOfFirst()‎]]</code>: تجلب فهرس أول عنصر يحقِّق شرطًا معيَّنًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-last.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
*الخاصية <code>‎‎[[Kotlin/collections/lastIndex|lastIndex]]</code>: تجلب الفهرس الأخير لمصفوفة أو قائمة.
*التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد.
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-last.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Methods]]

مراجعة 07:05، 24 يوليو 2018

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

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

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

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

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

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

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

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

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

أمثلة

استخدام الدالةindexOfLast()‎ مع عنصر متطابق

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

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

    print(array.indexOfLast { it > 2 }) // 5
}

استخدام الدالةindexOfLast()‎ مع عنصر غير متطابق 

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()indexOfLast لجلب فهرس آخر عنصر سالب:

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

    print(array.indexOfLast { it < 0 }) // -1
}

انظر أيضًا

مصادر

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