max

Платформа и требования к версии: Common (1.7)


@JvmName(name = "maxOrThrow")
fun Array<out Double>.max(): Double


@JvmName(name = "maxOrThrow")
fun Array<out Float>.max(): Float


@JvmName(name = "maxOrThrow")
fun FloatArray.max(): Float


@JvmName(name = "maxOrThrow")
fun DoubleArray.max(): Double

Возвращает наибольший элемент.

Если какой-либо из элементов равен NaN, эта функция возвращает NaN.

Исключения

NoSuchElementException

если массив пуст.

Примеры

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
}


@JvmName(name = "maxOrThrow")
fun <T : Comparable<T>> Array<out T>.max(): T

Возвращает наибольший элемент.

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

Исключения

NoSuchElementException

если массив пуст.

Примеры

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
}


@JvmName(name = "maxOrThrow")
fun ByteArray.max(): Byte


@JvmName(name = "maxOrThrow")
fun ShortArray.max(): Short


@JvmName(name = "maxOrThrow")
fun IntArray.max(): Int


@JvmName(name = "maxOrThrow")
fun LongArray.max(): Long


@JvmName(name = "maxOrThrow")
fun CharArray.max(): Char



@JvmName(name = "maxOrThrow-U")


@ExperimentalUnsignedTypes

fun UIntArray.max(): UInt



@JvmName(name = "maxOrThrow-U")


@ExperimentalUnsignedTypes

fun ULongArray.max(): ULong



@JvmName(name = "maxOrThrow-U")


@ExperimentalUnsignedTypes

fun UByteArray.max(): UByte



@JvmName(name = "maxOrThrow-U")


@ExperimentalUnsignedTypes

fun UShortArray.max(): UShort

Возвращает наибольший элемент.

Исключения

NoSuchElementException

если массив пуст.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   // The largest and smallest elements in the array
val numbers = intArrayOf(3, 7, 2, 6)
println(numbers.max()) // 7
println(numbers.min()) // 2

val emptyArray = intArrayOf()

// 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
}


@JvmName(name = "maxOrThrow")
fun Iterable<Double>.max(): Double


@JvmName(name = "maxOrThrow")
fun Iterable<Float>.max(): Float

Возвращает наибольший элемент.

Если какой-либо из элементов равен NaN, эта функция возвращает NaN.

Исключения

NoSuchElementException

если коллекция пуста.

Примеры

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
}


@JvmName(name = "maxOrThrow")
fun <T : Comparable<T>> Iterable<T>.max(): T

Возвращает наибольший элемент.

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

Исключения

NoSuchElementException

если коллекция пуста.

Примеры

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
}

Платформа и требования к версии: JVM (1.1)

fun DoubleArray.max(): Double?

fun FloatArray.max(): Float?

fun Iterable<Double>.max(): Double?

fun Iterable<Float>.max(): Float?

Устарело

Предупреждение начиная с версии 1.4

Ошибка начиная с версии 1.5

Скрыто начиная с версии 1.6

Используйте вместо этого maxOrNull.

Заменить на

this.maxOrNull()

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

fun ByteArray.max(): Byte?

fun ShortArray.max(): Short?

fun IntArray.max(): Int?

fun LongArray.max(): Long?

fun FloatArray.max(): Float?

fun DoubleArray.max(): Double?

fun CharArray.max(): Char?

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

Устарело

Предупреждение начиная с версии 1.4

Ошибка начиная с версии 1.5

Скрыто начиная с версии 1.6

Используйте вместо этого maxOrNull.

Заменить на

this.maxOrNull()


@ExperimentalUnsignedTypes
fun UIntArray.max(): UInt?


@ExperimentalUnsignedTypes
fun ULongArray.max(): ULong?


@ExperimentalUnsignedTypes
fun UByteArray.max(): UByte?


@ExperimentalUnsignedTypes
fun UShortArray.max(): UShort?

Устарело

Предупреждение начиная с версии 1.4

Ошибка начиная с версии 1.5

Скрыто начиная с версии 1.6

Используйте вместо этого maxOrNull.

Заменить на

this.maxOrNull()

© 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.collections/max.html