Функция maxOrNull

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

Импорт

import kotlin.collections.maxOrNull

Синтаксис

fun <T : Comparable<T>> Array<out T>.maxOrNull(): T?

fun <T : Comparable<T>> Iterable<T>.maxOrNull(): T?

fun <K, V : Comparable<V>> Map<out K, V>.maxOrNull(): Map.Entry<K, V>?

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

Функция maxOrNull работает со следующими типами коллекций:

Array - массивы
List - списки
Set - множества
Map - словари (возвращает максимальную пару ключ-значение по значению)
Iterable - любые итерируемые коллекции

Пример

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

val numbers = arrayOf(5, 2, 8, 1, 9, 3)
val res = numbers.maxOrNull()
println(res)

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

Int 9

Пример

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

val letters = listOf('a', 'c', 'e', 'b', 'd')
val res = letters.maxOrNull()
println(res)

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

Char e

Пример

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

val emptyList = emptyList<Int>()
val res = emptyList.maxOrNull()
println(res)

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

null

Пример

Найдем максимальную пару ключ-значение в словаре по значению:

val map = mapOf("a" to 10, "b" to 5, "c" to 15)
val res = map.maxOrNull()
println(res)

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

c=15

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

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