Kotlin/collections/any

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

حالات استدعاء الدالة any()‎

• في حال استدعاء الدالة any()‎ مع مصفوفة (array) أو مجموعة (collection) دون تمرير أيّ معامل (parameter) لها، فستعيد القيمة true إن كانت المصفوفة أو المجموعة تحتوي على عنصر ٍ واحدٍ على الأقل (أي أنها غير فارغة)، وتعيد القيمة false بخلاف ذلك.
• في حال تمرير دالةٍ ما كوسيطٍ (parameter) في الدالة any()‎ فستعيد القيمة true إن كان هناك واحدٌ على الأقل من عناصر المصفوفة أو المجموعة (التي استُدعيت عبرها الدالة any) يحقق العبارة المنطقية (predicate) المُحدَّدة، وتعيد القيمة false بخلاف ذلك.
• في حال استدعاء الدالة any()‎ مع خريطة (map) وتمرير دالةٍ لها كمعامل (parameter)، فستُعيد القيمة true إن كان هناك واحدٌ على الأقل من أزواجها التي استُدعيت معها تحقق العبارة المنطقية (predicate) المُحدَّدة.
• إن استُدعيت مع خريطة دون تمرير أيّ معاملٍ (parameter) إليها، فستعيد القيمةtrue إن كانت الخريطة تحتوي على زوج واحدٍ على الأقل، وتعيد القيمة 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()‎عبر خريطة بتمرير دالةٍ منطقيةٍ (predicate) كمعامل (parameter):

inline fun <K, V> Map<out K, V>.any(predicate: (Entry<K, V>) -> Boolean): Boolean

استدعاء الدالة any()‎عبر خريطة دون معامل (parameter):

fun <K, V> Map<out K, V>.any(): Boolean

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

المعاملات

predicate

دالة تطبق على كل عنصر من عناصر المصفوفة أو الكائن iterable المعطى أو على كل زوج من أزواج الخريطة المعطاة، وتعيد القيمة المنطقية المقابلة لذلك العنصر أو الزوج.

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

القيمة المنطقية 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.