Kotlin/collections/any

يختلف سلوك الدالة any()‎ بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.

حالات استدعاء الدالة 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 بخلاف ذلك.

مصادر

• صفحة الدالة any()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.