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

تجلب الدالة min()‎ أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها.

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

fun Array<out Double>.min(): Double? 
fun Array<out Float>.min(): Float?
fun FloatArray.min(): Float? 
fun DoubleArray.min(): Double? 
fun Iterable<Double>.min(): Double?
fun Iterable<Float>.min(): Float?

fun <T : Comparable<T>> Array<out T>.min(): T? 
fun ByteArray.min(): Byte? 
fun ShortArray.min(): Short? 
fun IntArray.min(): Int? 
fun LongArray.min(): Long? 
fun CharArray.min(): Char? 
fun <T : Comparable<T>> Iterable<T>.min(): T?

الإصدار المطلوب: Kotlin 1.1.

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

يُعاد أصغر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو المجموعة فارغة، أو القيمة NaN إن كانت قيمة أيّ عنصر من العناصر تساوي NaN.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستدعي الدالة ()max لجلب أصغر عدد موجود في تلك المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(0, 2, 3, 4, 7, 5)

    println(array.min()) // 0
}

انظر أيضًا

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

مصادر

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