الدالة minWith()‎ في Kotlin

تجلب الدالة minWith()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن comparator المعطى.

البنية العامة

يمكن استدعاء الدالة maxWith()‎ مع المصفوفات و المجموعات والخرائط:

fun <T> Array<out T>.minWith(
    comparator: Comparator<in T>
): T? (source)
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte? (source)
fun ShortArray.minWith(
    comparator: Comparator<in Short>
): Short? (source)
fun IntArray.minWith(comparator: Comparator<in Int>): Int? (source)
fun LongArray.minWith(comparator: Comparator<in Long>): Long? (source)
fun FloatArray.minWith(
    comparator: Comparator<in Float>
): Float? (source)
fun DoubleArray.minWith(
    comparator: Comparator<in Double>
): Double? (source)
fun BooleanArray.minWith(
    comparator: Comparator<in Boolean>
): Boolean? (source)
fun CharArray.minWith(comparator: Comparator<in Char>): Char? (source)
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T? (source)

fun <K, V> Map<out K, V>.minWith(
    comparator: Comparator<in Entry<K, V>>
): Entry<K, V>? (source)

المعاملات

comparator

دالةٌ تمثل الموزان الذي سيُطبَّق على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة.

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

يُعاد العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة المعطاة والذي له أصغر قيمة بحسب الدالة comparator الموازنة المعطاة، أو القيمة null إن لم يكن هنالك أي عنصر.

أمثلة

تعرف الشيفرة الآتية مصفوفةً باسم array باستخدام الدالة ()arrayOf ثم تستدعي الدالة ()maxWith مع تلك المصفوفة مع تمرير الدالة comparator الموازنة:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 4, 8, 16, 32)

    println(array.minWith(Comparator { a, b -> b - a })) // 32
}

انظر أيضًا

• الدالة maxWith()‎: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.
• الدالة min()‎: تجلب أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها.
• الدالة minBy()‎: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.

مصادر

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