الفرق بين المراجعتين لصفحة: «Kotlin/collections/findLast»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>findLast()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>findLast()</code> العنصر الأو...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>findLast()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>findLast()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة<code>findLast()</code> العنصر | تعيد الدالة<code>findLast()</code> العنصر الأخير من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline fun <T> Array<out T>. | inline fun <T> Array<out T>.findLast( | ||
predicate: (T) -> Boolean | predicate: (T) -> Boolean | ||
): T? | ): T? | ||
inline fun ByteArray. | inline fun ByteArray.findLast( | ||
predicate: (Byte) -> Boolean | predicate: (Byte) -> Boolean | ||
): Byte? | ): Byte? | ||
inline fun ShortArray. | inline fun ShortArray.findLast( | ||
predicate: (Short) -> Boolean | predicate: (Short) -> Boolean | ||
): Short? | ): Short? | ||
inline fun IntArray. | inline fun IntArray.findLast( | ||
inline fun LongArray. | predicate: (Int) -> Boolean | ||
): Int? | |||
inline fun LongArray.findLast( | |||
predicate: (Long) -> Boolean | predicate: (Long) -> Boolean | ||
): Long? | ): Long? | ||
inline fun FloatArray. | inline fun FloatArray.findLast( | ||
predicate: (Float) -> Boolean | predicate: (Float) -> Boolean | ||
): Float? | ): Float? | ||
inline fun DoubleArray. | inline fun DoubleArray.findLast( | ||
predicate: (Double) -> Boolean | predicate: (Double) -> Boolean | ||
): Double? | ): Double? | ||
inline fun BooleanArray. | inline fun BooleanArray.findLast( | ||
predicate: (Boolean) -> Boolean | predicate: (Boolean) -> Boolean | ||
): Boolean? | ): Boolean? | ||
inline fun CharArray. | inline fun CharArray.findLast( | ||
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
): Char? | ): Char? | ||
inline fun <T> Iterable<T>. | inline fun <T> Iterable<T>.findLast( | ||
predicate: (T) -> Boolean | |||
): T? | |||
inline fun <T> List<T>.findLast( | |||
predicate: (T) -> Boolean | predicate: (T) -> Boolean | ||
): T? | ): T? | ||
| سطر 34: | سطر 39: | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
العنصر | العنصر الأخير من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()findLast</code> مع المصفوفات: الحالة الأولى=== | ===استخدام الدالة <code>()findLast</code> مع المصفوفات: الحالة الأولى=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تُعرّف الدالة المنطقية <code>()predicate</code> التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>3</code> ، ثم تستخدم الدالة <code>()findLast</code> لإيجاد | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تُعرّف الدالة المنطقية <code>()predicate</code> التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>3</code> ، ثم تستخدم الدالة <code>()findLast</code> لإيجاد العنصر الأخير في [[Kotlin/Array|المصفوفة]]<code>array</code> الذي يحقق الدالة <code>()predicate</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(9, 2, 3, 2, 5, | val array = arrayOf(9, 2, 3, 2, 5, 6) | ||
val predicate : (Int) -> Boolean = { it < 3 } | val predicate : (Int) -> Boolean = { it < 3 } | ||
println(array. | println(array.findLast(predicate)) // 2 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>()findLast</code> مع المصفوفات: الحالة الثانية=== | ===استخدام الدالة <code>()findLast</code> مع المصفوفات: الحالة الثانية=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تُعرّف الدالة المنطقية <code>()predicate</code> التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>0</code> ، ثم تستخدم الدالة <code>()findLast</code> لإيجاد | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تُعرّف الدالة المنطقية <code>()predicate</code> التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>0</code> ، ثم تستخدم الدالة <code>()findLast</code> لإيجاد العنصر الأخير في [[Kotlin/Array|المصفوفة]]<code>array</code> الذي يحقق الدالة <code>()predicate</code>، ولمّا كانت كل عناصر <code>array</code> لا تحقق ذلك فستعيد القيمة <code>null</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(9, 2, 3, 2, 5, 1) | val array = arrayOf(9, 2, 3, 2, 5, 1) | ||
| سطر 55: | سطر 60: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/collections/ | *<code>[[Kotlin/collections/find|find()]]</code>: تعيد العنصر الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/find.html الدالة findLast() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/find-last.html الدالة findLast() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 18:53، 15 مايو 2018
تعيد الدالةfindLast() العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
البنية العامة
inline fun <T> Array<out T>.findLast(
predicate: (T) -> Boolean
): T?
inline fun ByteArray.findLast(
predicate: (Byte) -> Boolean
): Byte?
inline fun ShortArray.findLast(
predicate: (Short) -> Boolean
): Short?
inline fun IntArray.findLast(
predicate: (Int) -> Boolean
): Int?
inline fun LongArray.findLast(
predicate: (Long) -> Boolean
): Long?
inline fun FloatArray.findLast(
predicate: (Float) -> Boolean
): Float?
inline fun DoubleArray.findLast(
predicate: (Double) -> Boolean
): Double?
inline fun BooleanArray.findLast(
predicate: (Boolean) -> Boolean
): Boolean?
inline fun CharArray.findLast(
predicate: (Char) -> Boolean
): Char?
inline fun <T> Iterable<T>.findLast(
predicate: (T) -> Boolean
): T?
inline fun <T> List<T>.findLast(
predicate: (T) -> Boolean
): T?
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد null.
أمثلة
استخدام الدالة ()findLast مع المصفوفات: الحالة الأولى
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تُعرّف الدالة المنطقية ()predicate التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من 3 ، ثم تستخدم الدالة ()findLast لإيجاد العنصر الأخير في المصفوفةarray الذي يحقق الدالة ()predicate، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(9, 2, 3, 2, 5, 6)
val predicate : (Int) -> Boolean = { it < 3 }
println(array.findLast(predicate)) // 2
}
استخدام الدالة ()findLast مع المصفوفات: الحالة الثانية
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تُعرّف الدالة المنطقية ()predicate التي تحدد ما إذا كان العدد المُمرّر إليها أصغر من 0 ، ثم تستخدم الدالة ()findLast لإيجاد العنصر الأخير في المصفوفةarray الذي يحقق الدالة ()predicate، ولمّا كانت كل عناصر array لا تحقق ذلك فستعيد القيمة null، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(9, 2, 3, 2, 5, 1)
val predicate : (Int) -> Boolean = { it < 0 }
println(array.find(predicate)) // null
}
انظر أيضًا
find(): تعيد العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقيpredicateالمُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيدnull.