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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة indexOfLast()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOfLast()‎</code> فهرس أول ظهور ل...')
 
سطر 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>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
 
== البنية العامة ==
 
== البنية العامة ==
 
يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
 
يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.indexOfFirst(
+
inline fun <T> Array<out T>.indexOfLast(
 
     predicate: (T) -> Boolean
 
     predicate: (T) -> Boolean
 
): Int  
 
): Int  
inline fun ByteArray.indexOfFirst(
+
inline fun ByteArray.indexOfLast(
 
     predicate: (Byte) -> Boolean
 
     predicate: (Byte) -> Boolean
): Int  
+
): Int
inline fun ShortArray.indexOfFirst(
+
inline fun ShortArray.indexOfLast(
 
     predicate: (Short) -> Boolean
 
     predicate: (Short) -> Boolean
 
): Int  
 
): Int  
inline fun IntArray.indexOfFirst(
+
inline fun IntArray.indexOfLast(
 
     predicate: (Int) -> Boolean
 
     predicate: (Int) -> Boolean
 
): Int  
 
): Int  
inline fun LongArray.indexOfFirst(
+
inline fun LongArray.indexOfLast(
 
     predicate: (Long) -> Boolean
 
     predicate: (Long) -> Boolean
 
): Int  
 
): Int  
inline fun FloatArray.indexOfFirst(
+
inline fun FloatArray.indexOfLast(
 
     predicate: (Float) -> Boolean
 
     predicate: (Float) -> Boolean
 
): Int  
 
): Int  
inline fun DoubleArray.indexOfFirst(
+
inline fun DoubleArray.indexOfLast(
 
     predicate: (Double) -> Boolean
 
     predicate: (Double) -> Boolean
 
): Int  
 
): Int  
inline fun BooleanArray.indexOfFirst(
+
inline fun BooleanArray.indexOfLast(
 
     predicate: (Boolean) -> Boolean
 
     predicate: (Boolean) -> Boolean
 
): Int  
 
): Int  
inline fun CharArray.indexOfFirst(
+
inline fun CharArray.indexOfLast(
 
     predicate: (Char) -> Boolean
 
     predicate: (Char) -> Boolean
): Int
+
): Int  
  
 
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
 
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
inline fun <T> Iterable<T>.indexOfFirst(
+
inline fun <T> Iterable<T>.indexOfLast(
 
     predicate: (T) -> Boolean
 
     predicate: (T) -> Boolean
 
): Int
 
): Int
 
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/List|اللوائح]]:<syntaxhighlight lang="kotlin">
 
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOfLast()‎</code> عبر [[Kotlin/List|اللوائح]]:<syntaxhighlight lang="kotlin">
inline fun <T> List<T>.indexOfFirst(
+
inline fun <T> List<T>.indexOfLast(
 
     predicate: (T) -> Boolean
 
     predicate: (T) -> Boolean
 
): Int
 
): Int
سطر 42: سطر 42:
  
 
== القيم المعادة ==
 
== القيم المعادة ==
فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
فهرس آخر ظهور للعنصر المُمرّر إلى الدالة <code>indexOfLast()‎</code> في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
 
== أمثلة ==
 
== أمثلة ==
  
 
=== استخدام الدالة<code>indexOfLast()‎</code> على مصفوفة: الحالة الأولى ===
 
=== استخدام الدالة<code>indexOfLast()‎</code> على مصفوفة: الحالة الأولى ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOfLast</code>  للحصول على فهرس أول ظهور لعدد أكبر من <code>2</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <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.indexOfFirst { it > 2 }) // 2
+
     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>  للحصول على فهرس أول ظهور لعدد أكبر من <code>8</code>، <nowiki/>ولمّا كانت كل عناصر المصفوفة <code>array</code> أصغر من العدد <code>8</code>، فستعيد الدالة <code>()indexOfFirst</code> القيمة ‎<code>-1‎‎</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.indexOfFirst { it > 8 }) // -1
+
     print(array.indexOfLast { it > 8 }) // -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>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو <nowiki/>[[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
 +
 +
* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-first.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+
[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-last.html الدالة indexOfLast()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

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

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

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

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

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

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

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

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

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

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

فهرس آخر ظهور للعنصر المُمرّر إلى الدالة indexOfLast()‎ في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر 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  للحصول على فهرس آخر ظهور لعدد أكبر من 8، ولمّا كانت كل عناصر المصفوفة array أصغر من العدد 8، فستعيد الدالة ()indexOfLast القيمة ‎-1‎‎:

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

    print(array.indexOfLast { it > 8 }) // -1
}

انظر أيضًا

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

مصادر

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