max Or Null
Начиная с Kotlin: 1.4
fun Sequence<Double>.maxOrNull(): Double?
fun Sequence<Float>.maxOrNull(): Float?
Возвращает наибольший элемент или null, если последовательность пуста.
Если какой-либо из элементов равен NaN, эта функция возвращает NaN.
Операция является завершающей.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//sampleStart
// The largest and smallest elements in the array
val numbers = doubleArrayOf(3.0, 7.2, 2.4, 6.5)
println(numbers.max()) // 7.2
println(numbers.min()) // 2.4
// max() and min() return `NaN` if any of elements is `NaN`
val numbersWithNaN = doubleArrayOf(3.0, Double.NaN, 7.2, 2.4, 6.5)
println(numbersWithNaN.max()) // NaN
println(numbersWithNaN.min()) // NaN
val emptyArray = doubleArrayOf()
// max() and min() throw if the array is empty
// emptyArray.max() // will fail with NoSuchElementException
// emptyArray.min() // will fail with NoSuchElementException
// maxOrNull() and minOrNull() return null if the array is empty
println(emptyArray.maxOrNull()) // null
println(emptyArray.minOrNull()) // null
//sampleEnd
}
fun <T : Comparable<T>> Sequence<T>.maxOrNull(): T?
Возвращает наибольший элемент или null, если последовательность пуста.
Если есть несколько равных максимальных элементов, эта функция возвращает первый из них.
Операция является завершающей.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//sampleStart
// The largest and smallest elements according to String.compareTo
val names = listOf("Alice", "Bob", "Carol")
println(names.max()) // Carol
println(names.min()) // Alice
val emptyList = emptyList<Int>()
// max() and min() throw if the collection is empty
// emptyList.max() // will fail with NoSuchElementException
// emptyList.min() // will fail with NoSuchElementException
// maxOrNull() and minOrNull() return null if the collection is empty
println(emptyList.maxOrNull()) // null
println(emptyList.minOrNull()) // null
//sampleEnd
}
© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.sequences/max-or-null.html