minBy

Common
JVM
JS
Native
1.0
inline fun <T, R : Comparable<R>> Array<out T>.minBy(
    selector: (T) -> R
): T?
inline fun <R : Comparable<R>> ByteArray.minBy(
    selector: (Byte) -> R
): Byte?
inline fun <R : Comparable<R>> ShortArray.minBy(
    selector: (Short) -> R
): Short?
inline fun <R : Comparable<R>> IntArray.minBy(
    selector: (Int) -> R
): Int?
inline fun <R : Comparable<R>> LongArray.minBy(
    selector: (Long) -> R
): Long?
inline fun <R : Comparable<R>> FloatArray.minBy(
    selector: (Float) -> R
): Float?
inline fun <R : Comparable<R>> DoubleArray.minBy(
    selector: (Double) -> R
): Double?
inline fun <R : Comparable<R>> BooleanArray.minBy(
    selector: (Boolean) -> R
): Boolean?
inline fun <R : Comparable<R>> CharArray.minBy(
    selector: (Char) -> R
): Char?
inline fun <T, R : Comparable<R>> Iterable<T>.minBy(
    selector: (T) -> R
): T?
inline fun <R : Comparable<R>> UIntArray.minBy(
    selector: (UInt) -> R
): UInt?
inline fun <R : Comparable<R>> ULongArray.minBy(
    selector: (ULong) -> R
): ULong?
inline fun <R : Comparable<R>> UByteArray.minBy(
    selector: (UByte) -> R
): UByte?
inline fun <R : Comparable<R>> UShortArray.minBy(
    selector: (UShort) -> R
): UShort?

Returns the first element yielding the smallest value of the given function or null if there are no elements.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf("abcd", "abc", "ab", "abcde")
val shortestString = list.minBy { it.length }
println(shortestString) // ab

val emptyList = emptyList<String>()
val emptyMin = emptyList.minBy { it.length }
println(emptyMin) // null
//sampleEnd
}
Common
JVM
JS
Native
1.0
inline fun <K, V, R : Comparable<R>> Map<out K, V>.minBy(
    selector: (Entry<K, V>) -> R
): Entry<K, V>?

Returns the first entry yielding the smallest value of the given function or null if there are no entries.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf("abcd", "abc", "ab", "abcde")
val shortestString = list.minBy { it.length }
println(shortestString) // ab

val emptyList = emptyList<String>()
val emptyMin = emptyList.minBy { it.length }
println(emptyMin) // null
//sampleEnd
}