الدالة any() في لغة Kotlin
يختلف سلوك الدالة any() بحسب طريقة استدعائها:
- في حال استدعاء الدالة
any()عبر مصفوفة (array) أو مجموعة (collection) دون تمرير أيّ معامل (parameter) لها فستعيد القيمةtrueإن كانت المصفوفة أو المجموعة تحتوي على عنصر ٍ واحدٍ على الأقل (أي أنها غير فارغة)، وتعيد القيمةfalseبخلاف ذلك. - في حال تمرير دالةٍ ما كوسيطٍ (parameter) في الدالة
any()فستعيد القيمةtrueإن كان هناك واحدٌ على الأقل من عناصر المصفوفة أو المجموعة (التي استُدعيت عبرها الدالةany) يحقق العبارة المنطقية (predicate) المُحدَّدة، وتعيد القيمةfalseبخلاف ذلك. - في حال استدعاء الدالة
any()عبر عنصر map وتمرير دالةٍ لها كمعامل (parameter)، فستُعيد القيمةtrueإن كان هناك واحدٌ على الأقل من مداخل (entries) عنصر map الذي استُدعيت عبره يحقق العبارة المنطقية (predicate) المُحدَّدة. - إن استُدعيت عبر عنصر map دون تمرير أيّ معاملٍ (parameter) إليها، فستعيد القيمة
trueإن كان عنصر map يحتوي على مدخلٍ (entry) واحدٍ على الأقل، وتعيد القيمةfalseبخلاف ذلك.
البنية العامة
استدعاء الدالة any()عبر مصفوفة بدون معامل (parameter) وبحسب نوعها:
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()عبر مصفوفة بتمرير دالةٍ منطقيةٍ (predicate) كمعامل (parameter) وبحسب نوعها:
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) دون معامل (parameter):
fun <T> Iterable<T>.any(): Boolean
استدعاء الدالة any()عبر عنصر map بتمرير دالةٍ منطقيةٍ (predicate) كمعامل (parameter):
inline fun <K, V> Map<out K, V>.any(predicate: (Entry<K, V>) -> Boolean): Boolean
استدعاء الدالة any()عبر عنصر map دون معامل (parameter):
fun <K, V> Map<out K, V>.any(): Boolean
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
القيمة المنطقية true أو false (انظر شرح الدالة أعلاه لمزيد من التفاصيل).
أمثلة
استخدام الدالة ()any مع قائمة (List) دون تمرير معامل (Parameter)
تعرِّف الشيفرة الآتية قائمةً (list) فارغةً باسم emptyList باستخدام الدالة emptyList<Int>()، ثم تعرِّف قائمة أخرى من 3 أعداد صحيحة باسم nonEmptyList وذلك باستخدام الدالة listOf()وتطبع القيمة الناتجة عن استدعاء الدالة()any على اللائحتين، وستنتج القيمة false بالقائمة الأولى لأن القائمة فارغة، والقيمة true بالقائمة الثانية لأنها تحتوي عنصرًا واحدًا على الأقل:
fun main(args: Array<String>) {
val emptyList = emptyList<Int>()
println(emptyList.any()) // false
val nonEmptyList = listOf(1, 2, 3)
println(nonEmptyList.any()) // true
}
استخدام الدالة ()any بتمرير دالة كمعامل لها
تعرِّف الشيفرة الآتية دالةً باسم isEven لاختبار زوجية الأعداد (بالاعتماد على باقي القسمة على العدد 2) إذ تعيد قيمة true إن كان العدد زوجيًا وfalse إن كان فرديًا ، ثم تعرِّف مجالًا (range) باسم zeroToTen يحتوي على القيم من 0 وحتى القيمة 10، ثم تطبع قيمة ناتج استدعاء الدالة ()any وهي true على ذلك المجال لوجود عنصر زوجيّ واحدٍ على الأقل، ثم تعرِّف مجالًا باسم odds مكونًا من أعداد فردية فقط وذلك باستخدام الدالة map() وتستدعي عبر هذا المجال الدالة ()any ثم تطبع القيمة الناتجة وهي false لأنّه لا يوجد أيّ عنصر زوجيّ في المجال، وفي النهاية تستدعي الدالة ()any على قائمةٍ فارغة وتطبع الناتج وهو القيمة false لأنّ القائمة فارغة، تصبح الشيفرة بالشكل:
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بخلاف ذلك.