Функция minOrNull

Функция minOrNull возвращает наименьший элемент в коллекции согласно естественному порядку сортировки или null, если коллекция пустая. Работает с любыми коллекциями, элементы которых можно сравнивать между собой.

Импорт

kotlinimport kotlin.collections.minOrNull

Синтаксис

kotlin// Для коллекций, реализующих интерфейс Iterable
fun <T : Comparable<T>> Iterable<T>.minOrNull(): T?

// Для массивов
fun Array<out T>.minOrNull(): T?
fun ByteArray.minOrNull(): Byte?
fun ShortArray.minOrNull(): Short?
fun IntArray.minOrNull(): Int?
fun LongArray.minOrNull(): Long?
fun FloatArray.minOrNull(): Float?
fun DoubleArray.minOrNull(): Double?
fun CharArray.minOrNull(): Char?
fun UIntArray.minOrNull(): UInt?
fun ULongArray.minOrNull(): ULong?
fun UByteArray.minOrNull(): UByte?
fun UShortArray.minOrNull(): UShort?

Поддерживаемые типы коллекций

Функция minOrNull доступна для следующих типов:

Для Map функция недоступна напрямую, но можно использовать values.minOrNull() для поиска минимального значения или keys.minOrNull() для поиска минимального ключа.

Пример

Найдем минимальный элемент в списке чисел:

kotlinval numbers = listOf(5, 2, 8, 1, 9)
val res = numbers.minOrNull()
println(res)

Результат выполнения кода:

kotlinInt 1

Пример

Найдем минимальный элемент в массиве строк:

kotlinval strings = arrayOf("zebra", "apple", "banana")
val res = strings.minOrNull()
println(res)

Результат выполнения кода:

kotlinString "apple"

Пример

Работа с пустой коллекцией возвращает null:

kotlinval emptyList = emptyList<Int>()
val res = emptyList.minOrNull()
println(res)

Результат выполнения кода:

kotlinnull

Пример

Использование с примитивными массивами:

kotlinval intArray = intArrayOf(10, 3, 7, 15, 2)
val res = intArray.minOrNull()
println(res)

Результат выполнения кода:

kotlinInt 2

Пример

Работа с множеством (Set):

kotlinval numberSet = setOf(45, 12, 67, 23, 89)
val res = numberSet.minOrNull()
println(res)

Результат выполнения кода:

kotlinInt 12

Смотрите также

  • функцию maxOrNull,
    которая возвращает максимальный элемент коллекции
  • функцию min,
    которая возвращает минимальный элемент, но бросает исключение для пустой коллекции