الدالة asIterable() في لغة Kotlin
يختلف سلوك الدالة asIterable() بحسب طريقة استدعائها:
- في حال استدعاء الدالة
asIterable()عبر مصفوفة أو مجموعة (collection) دون تمرير أيّ معامل (parameter) لها فستعيد القيمةtrueإن كانت المصفوفة أو المجموعة تحتوي على عنصر واحد على الأقل، أوfalseخلاف ذلك. - في حال تمرير دالة كوسيط إلى المصفوفة أو المجموعة التي استُدعيت الدالة
asIterable()عبرها فستعيد القيمةtrueإن كان واحد على الأقل من عناصر المصفوفة أو المجموعةيحقق العبارة المنطقية (predicate) المحددة، أوfalseخلاف ذلك - في حال استدعاء الدالة
asIterable()عبر قاموس (Map) وتمرير دالة لها كمعامل، فستُعيد القيمةtrueإن كان واحد على الأقل من مداخل (entries) القاموس الذي استُدعيت عبره يحقق العبارة المنطقية (predicate) المحددة: - إن استُدعيت عبر قاموس دون تمرير أي معامل (parameter) إليها، فستعيدالقيمة
trueإن كان القاموس يحتوي على مدخل (entry) واحد على الأقل، أوfalseخلاف ذلك.
البنية العامة
يمكن استدعاء الدالة asIterable()عبر مصفوفة دون معامل:
fun <T> Array<out T>.any(): Boolean
fun ByteArray.any(): Boolean )
fun ShortArray.any(): Boolean
fun IntArray.any(): Boolean
fun LongArray.any(): Boolean
fun FloatArray.any(): Boolean
fun DoubleArray.any(): Boolean
fun BooleanArray.any(): Boolean
fun CharArray.any(): Boolean
يمكن استدعاء الدالة any()عبر مصفوفة بتمرير دالة كمعامل:
inline fun <T> Array<out T>.any(predicate: (T) -> Boolean): Boolean
inline fun ByteArray.any(predicate: (Byte) -> Boolean): Boolean
inline fun ShortArray.any(predicate: (Short) -> Boolean): Boolean
inline fun IntArray.any(predicate: (Int) -> Boolean): Boolean
inline fun LongArray.any(predicate: (Long) -> Boolean): Boolean
inline fun FloatArray.any(predicate: (Float) -> Boolean): Boolean
inline fun DoubleArray.any(predicate: (Double) -> Boolean): Boolean
inline fun BooleanArray.any(predicate: (Boolean) -> Boolean): Boolean
inline fun CharArray.any(predicate: (Char) -> Boolean): Boolean
يمكن استدعاء الدالة any()عبر مُكرر (iterable) بتمرير دالة كمعامل:
inline fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean
يمكن استدعاء الدالة any()عبر مُكرر (iterable) دون معامل:
fun <T> Iterable<T>.any(): Boolean
يمكن استدعاء الدالة any()عبر قاموس (Map) بتمرير دالة كمعامل:
inline fun <K, V> Map<out K, V>.any(predicate: (Entry<K, V>) -> Boolean): Boolean
يمكن استدعاء الدالة any()عبر قاموس (Map) دون معامل:
fun <K, V> Map<out K, V>.any(): Boolean
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
true أو false. (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
أمثلة
استخدام الدالة ()asIterable على اللوائح دون تمرير مُعامل
تعرف الشيفرة الآتية لائحة (list) فارغة باسم emptyList باستخدام الدالة emptyList<Int>()، ثم تعرف لائحة من 3 عناصر عددية باستخدام الدالة listOf()وتطبع قيمة استدعاء الدالة()any على كلا اللائحتين:
fun main(args: Array<String>) {
val emptyList = emptyList<Int>()
println(emptyList.any()) // false
val nonEmptyList = listOf(1, 2, 3)
println(nonEmptyList.any()) // true
}
استخدام الدالة ()any بتمرير دالة كمُعامل
تعرف الشيفرة الآتيةدالة باسم isEvent لاختبار زوجية الأعداد، ثم تعرّف مجالًا (range) باسم zeroToTen وتطبع قيمة ناتج استدعاء الدالة ()any على ذلك المجال، ثم تعرف مجالًا باسم odds مكونًا من أعداد فردية باستخدام الدالة map() وتستدعي عبره الدالة ()any ثم تطبع الناتج، وفي الأخير تستدعي الدالة ()any على لائحة فارغة وتطبع الناتج:
fun main(args: Array<String>) {
val isEven: (Int) -> Boolean = { it % 2 == 0 }
val zeroToTen = 0..10
println(zeroToTen.any(isEven)) // true
val odds = zeroToTen.map { it * 2 + 1 }
println(odds.any { isEven(it) }) // false
val emptyList = emptyList<Int>()
println(emptyList.any { true }) // false
}
انظر أيضًا
all(): تُعيد القيمةtrueإن كانت كل عناصر المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المحددة، أوfalseخلاف ذلك.