الدالة minWith() في لغة Kotlin
تعيد الدالةminWith() العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أو null إن لم يكن هناك أي عنصر يحقق ذلك.
في حال استدعاء الدالة minWith() عبر قاموس فستعيد المدخل (Entry) الأول في ذلك القاموس والذي له أصغر قيمة حسب المقارِن comparator، أو null إن لم يكن هناك أي مدخل يحقق ذلك.
البنية العامة
يمكن استدعاء الدالة minWith() عبر المصفوفات و المجموعات:
fun <T> Array<out T>.minWith(
comparator: Comparator<in T>
): T?
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.minWith(
comparator: Comparator<in Short>
): Short?
fun IntArray.minWith(comparator: Comparator<in Int>): Int?
fun LongArray.minWith(comparator: Comparator<in Long>): Long?
fun FloatArray.minWith(
comparator: Comparator<in Float>
): Float?
fun DoubleArray.minWith(
comparator: Comparator<in Double>
): Double?
fun BooleanArray.minWith(
comparator: Comparator<in Boolean>
): Boolean?
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
بيئة التشغيل: JVM
fun <T> Array<out T>.minWith(
comparator: Comparator<in T>
): T?
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.minWith(
comparator: Comparator<in Short>
): Short?
fun IntArray.minWith(comparator: Comparator<in Int>): Int?
fun LongArray.minWith(comparator: Comparator<in Long>): Long?
fun FloatArray.minWith(
comparator: Comparator<in Float>
): Float?
fun DoubleArray.minWith(
comparator: Comparator<in Double>
): Double?
fun BooleanArray.minWith(
comparator: Comparator<in Boolean>
): Boolean?
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
بيئة التشغيل: JS
يمكن استدعاء الدالة minWith() عبر القواميس:
fun <K, V> Map<out K, V>.minWith(
comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?
بيئة التشغيل: JVM
fun <K, V> Map<out K, V>.minWith(
comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?
بيئة التشغيل: JS
القيم المٌعادة
العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أو null إن لم يكن هناك أي عنصر يحقق ذلك.
في حال استدعاء الدالة minWith() عبر قاموس فستعيد المدخل (Entry) الأول في ذلك القاموس والذي له أصغر قيمة حسب المقارِن comparator، أو null إن لم يكن هناك أي مدخل يحقق ذلك.
أمثلة
استخدام الدالة ()minWith مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستدعي الدالة ()minWith عبر array مع تمرير مقارِن comparator، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
println(array.minWith(Comparator { a, b -> b - a })) // 6
}