Spec-Zone.ru › Kotlin 2

Объявления уровня пакета

kotlin-stdlib/kotlin.comparisons

Вспомогательные функции для создания экземпляров Comparator.

Функции

compareBy

Требования к платформе и версии: Common (1.0)

inline fun <T> compareBy(crossinline selector: (T) -> Comparable<*>?): Comparator<T>

Создаёт компаратор, используя функцию для преобразования значения в экземпляр Comparable для сравнения.

fun <T> compareBy(vararg selectors: (T) -> Comparable<*>?): Comparator<T>

Создаёт компаратор, используя последовательность функций для вычисления результата сравнения. Функции вызываются последовательно, получают заданные значения a и b и возвращают объекты Comparable. Как только экземпляры Comparable, возвращённые функцией для значений a и b, оказываются не равны при сравнении, результат этого сравнения возвращается из Comparator.

inline fun <T, K> compareBy(comparator: Comparator<in K>, crossinline selector: (T) -> K): Comparator<T>

Создаёт компаратор, используя функцию selector для преобразования сравниваемых значений, а затем применяя указанный компаратор для сравнения преобразованных значений.

compareByDescending

Требования к платформе и версии: Common (1.0)

inline fun <T> compareByDescending(crossinline selector: (T) -> Comparable<*>?): Comparator<T>

Создаёт компаратор с обратным порядком, используя функцию для преобразования значения в экземпляр Comparable для сравнения.

inline fun <T, K> compareByDescending(comparator: Comparator<in K>, crossinline selector: (T) -> K): Comparator<T>

Создаёт компаратор с обратным порядком, используя функцию selector для преобразования сравниваемых значений, а затем применяя указанный компаратор для сравнения преобразованных значений.

compareValues

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<*>> compareValues(a: T?, b: T?): Int

Сравнивает два значения Comparable, которые могут быть null. Значение null считается меньше любого другого значения.

compareValuesBy

Требования к платформе и версии: Common (1.0)

inline fun <T> compareValuesBy(a: T, b: T, selector: (T) -> Comparable<*>?): Int

Сравнивает два значения, используя указанную функцию selector для вычисления результата сравнения. Функция применяется к заданным значениям a и b и возвращает объекты Comparable. Возвращается результат сравнения этих экземпляров Comparable.

fun <T> compareValuesBy(a: T, b: T, vararg selectors: (T) -> Comparable<*>?): Int

Сравнивает два значения, используя указанные функции selectors для вычисления результата сравнения. Функции вызываются последовательно, получают заданные значения a и b и возвращают объекты Comparable. Как только экземпляры Comparable, возвращённые функцией для значений a и b, оказываются не равны при сравнении, возвращается результат этого сравнения.

inline fun <T, K> compareValuesBy(a: T, b: T, comparator: Comparator<in K>, selector: (T) -> K): Int

Сравнивает два значения, используя указанную функцию selector для вычисления результата сравнения. Функция применяется к заданным значениям a и b и возвращает объекты типа K, которые затем сравниваются с помощью заданного компаратора.

maxOf

Требования к платформе и версии: Common (1.1)

expect fun <T : Comparable<T>> maxOf(a: T, b: T): T
expect inline fun maxOf(a: Byte, b: Byte): Byte
expect inline fun maxOf(a: Double, b: Double): Double
expect inline fun maxOf(a: Float, b: Float): Float
expect inline fun maxOf(a: Int, b: Int): Int
expect inline fun maxOf(a: Long, b: Long): Long
expect inline fun maxOf(a: Short, b: Short): Short

Возвращает большее из двух значений.

expect fun <T : Comparable<T>> maxOf(a: T, vararg other: T): T
expect fun maxOf(a: Byte, vararg other: Byte): Byte
expect fun maxOf(a: Double, vararg other: Double): Double
expect fun maxOf(a: Float, vararg other: Float): Float
expect fun maxOf(a: Int, vararg other: Int): Int
expect fun maxOf(a: Long, vararg other: Long): Long
expect fun maxOf(a: Short, vararg other: Short): Short
@ExperimentalUnsignedTypes
fun maxOf(a: UByte, vararg other: UByte): UByte
@ExperimentalUnsignedTypes
fun maxOf(a: UInt, vararg other: UInt): UInt
@ExperimentalUnsignedTypes
fun maxOf(a: ULong, vararg other: ULong): ULong
@ExperimentalUnsignedTypes
fun maxOf(a: UShort, vararg other: UShort): UShort

Возвращает наибольшее из заданных значений.

fun maxOf(a: UByte, b: UByte): UByte
fun maxOf(a: UInt, b: UInt): UInt
fun maxOf(a: ULong, b: ULong): ULong
fun maxOf(a: UShort, b: UShort): UShort

Возвращает большее из двух значений.

fun <T> maxOf(a: T, b: T, comparator: Comparator<in T>): T

Возвращает большее из двух значений согласно порядку, заданному указанным компаратором.

fun <T> maxOf(a: T, vararg other: T, comparator: Comparator<in T>): T

Возвращает наибольшее из заданных значений согласно порядку, заданному указанным компаратором.

expect fun <T : Comparable<T>> maxOf(a: T, b: T, c: T): T
expect inline fun maxOf(a: Byte, b: Byte, c: Byte): Byte
expect inline fun maxOf(a: Double, b: Double, c: Double): Double
expect inline fun maxOf(a: Float, b: Float, c: Float): Float
expect inline fun maxOf(a: Int, b: Int, c: Int): Int
expect inline fun maxOf(a: Long, b: Long, c: Long): Long
expect inline fun maxOf(a: Short, b: Short, c: Short): Short

Возвращает наибольшее из трёх значений.

inline fun maxOf(a: UByte, b: UByte, c: UByte): UByte
inline fun maxOf(a: UInt, b: UInt, c: UInt): UInt
inline fun maxOf(a: ULong, b: ULong, c: ULong): ULong
inline fun maxOf(a: UShort, b: UShort, c: UShort): UShort

Возвращает наибольшее из трёх значений.

fun <T> maxOf(a: T, b: T, c: T, comparator: Comparator<in T>): T

Возвращает наибольшее из трёх значений согласно порядку, заданному указанным компаратором.

Требования к платформе и версии: JS (1.1), JVM (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T : Comparable<T>> maxOf(a: T, b: T): T
actual inline fun maxOf(a: Byte, b: Byte): Byte
actual inline fun maxOf(a: Double, b: Double): Double
actual inline fun maxOf(a: Float, b: Float): Float
actual inline fun maxOf(a: Int, b: Int): Int
actual inline fun maxOf(a: Long, b: Long): Long
actual inline fun maxOf(a: Short, b: Short): Short

Возвращает большее из двух значений.

actual fun <T : Comparable<T>> maxOf(a: T, vararg other: T): T
actual fun maxOf(a: Byte, vararg other: Byte): Byte
actual fun maxOf(a: Double, vararg other: Double): Double
actual fun maxOf(a: Float, vararg other: Float): Float
actual fun maxOf(a: Int, vararg other: Int): Int
actual fun maxOf(a: Long, vararg other: Long): Long
actual fun maxOf(a: Short, vararg other: Short): Short

Возвращает наибольшее из заданных значений.

actual fun <T : Comparable<T>> maxOf(a: T, b: T, c: T): T
actual inline fun maxOf(a: Byte, b: Byte, c: Byte): Byte
actual inline fun maxOf(a: Double, b: Double, c: Double): Double
actual inline fun maxOf(a: Float, b: Float, c: Float): Float
actual inline fun maxOf(a: Int, b: Int, c: Int): Int
actual inline fun maxOf(a: Long, b: Long, c: Long): Long
actual inline fun maxOf(a: Short, b: Short, c: Short): Short

Возвращает наибольшее из трёх значений.

minOf

Требования к платформе и версии: Common (1.1)

expect fun <T : Comparable<T>> minOf(a: T, b: T): T
expect inline fun minOf(a: Byte, b: Byte): Byte
expect inline fun minOf(a: Double, b: Double): Double
expect inline fun minOf(a: Float, b: Float): Float
expect inline fun minOf(a: Int, b: Int): Int
expect inline fun minOf(a: Long, b: Long): Long
expect inline fun minOf(a: Short, b: Short): Short

Возвращает меньшее из двух значений.

expect fun <T : Comparable<T>> minOf(a: T, vararg other: T): T
expect fun minOf(a: Byte, vararg other: Byte): Byte
expect fun minOf(a: Double, vararg other: Double): Double
expect fun minOf(a: Float, vararg other: Float): Float
expect fun minOf(a: Int, vararg other: Int): Int
expect fun minOf(a: Long, vararg other: Long): Long
expect fun minOf(a: Short, vararg other: Short): Short
@ExperimentalUnsignedTypes
fun minOf(a: UByte, vararg other: UByte): UByte
@ExperimentalUnsignedTypes
fun minOf(a: UInt, vararg other: UInt): UInt
@ExperimentalUnsignedTypes
fun minOf(a: ULong, vararg other: ULong): ULong
@ExperimentalUnsignedTypes
fun minOf(a: UShort, vararg other: UShort): UShort

Возвращает наименьшее из заданных значений.

fun minOf(a: UByte, b: UByte): UByte
fun minOf(a: UInt, b: UInt): UInt
fun minOf(a: ULong, b: ULong): ULong
fun minOf(a: UShort, b: UShort): UShort

Возвращает меньшее из двух значений.

fun <T> minOf(a: T, b: T, comparator: Comparator<in T>): T

Возвращает меньшее из двух значений согласно порядку, заданному указанным компаратором.

fun <T> minOf(a: T, vararg other: T, comparator: Comparator<in T>): T

Возвращает наименьшее из заданных значений согласно порядку, заданному указанным компаратором.

expect fun <T : Comparable<T>> minOf(a: T, b: T, c: T): T
expect inline fun minOf(a: Byte, b: Byte, c: Byte): Byte
expect inline fun minOf(a: Double, b: Double, c: Double): Double
expect inline fun minOf(a: Float, b: Float, c: Float): Float
expect inline fun minOf(a: Int, b: Int, c: Int): Int
expect inline fun minOf(a: Long, b: Long, c: Long): Long
expect inline fun minOf(a: Short, b: Short, c: Short): Short

Возвращает наименьшее из трёх значений.

inline fun minOf(a: UByte, b: UByte, c: UByte): UByte
inline fun minOf(a: UInt, b: UInt, c: UInt): UInt
inline fun minOf(a: ULong, b: ULong, c: ULong): ULong
inline fun minOf(a: UShort, b: UShort, c: UShort): UShort

Возвращает наименьшее из трёх значений.

fun <T> minOf(a: T, b: T, c: T, comparator: Comparator<in T>): T

Возвращает наименьшее из трёх значений согласно порядку, заданному указанным компаратором.

Требования к платформе и версии: JS (1.1), JVM (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T : Comparable<T>> minOf(a: T, b: T): T
actual inline fun minOf(a: Byte, b: Byte): Byte
actual inline fun minOf(a: Double, b: Double): Double
actual inline fun minOf(a: Float, b: Float): Float
actual inline fun minOf(a: Int, b: Int): Int
actual inline fun minOf(a: Long, b: Long): Long
actual inline fun minOf(a: Short, b: Short): Short

Возвращает меньшее из двух значений.

actual fun <T : Comparable<T>> minOf(a: T, vararg other: T): T
actual fun minOf(a: Byte, vararg other: Byte): Byte
actual fun minOf(a: Double, vararg other: Double): Double
actual fun minOf(a: Float, vararg other: Float): Float
actual fun minOf(a: Int, vararg other: Int): Int
actual fun minOf(a: Long, vararg other: Long): Long
actual fun minOf(a: Short, vararg other: Short): Short

Возвращает наименьшее из заданных значений.

actual fun <T : Comparable<T>> minOf(a: T, b: T, c: T): T
actual inline fun minOf(a: Byte, b: Byte, c: Byte): Byte
actual inline fun minOf(a: Double, b: Double, c: Double): Double
actual inline fun minOf(a: Float, b: Float, c: Float): Float
actual inline fun minOf(a: Int, b: Int, c: Int): Int
actual inline fun minOf(a: Long, b: Long, c: Long): Long
actual inline fun minOf(a: Short, b: Short, c: Short): Short

Возвращает наименьшее из трёх значений.

naturalOrder

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<T>> naturalOrder(): Comparator<T>

Возвращает компаратор, сравнивающий объекты Comparable в естественном порядке.

nullsFirst

Требования к платформе и версии: Common (1.0)

inline fun <T : Comparable<T>> nullsFirst(): Comparator<T?>

Предоставляет компаратор для значений Comparable, допускающих null, считая значение null меньшим любого другого значения. Значения, отличные от null, сравниваются в соответствии с их естественным порядком.

fun <T : Any> nullsFirst(comparator: Comparator<in T>): Comparator<T?>

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

nullsLast

Требования к платформе и версии: Common (1.0)

inline fun <T : Comparable<T>> nullsLast(): Comparator<T?>

Предоставляет компаратор для значений Comparable, допускающих null, считая значение null большим любого другого значения. Значения, отличные от null, сравниваются в соответствии с их естественным порядком.

fun <T : Any> nullsLast(comparator: Comparator<in T>): Comparator<T?>

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

reversed

Требования к платформе и версии: Common (1.0)

fun <T> Comparator<T>.reversed(): Comparator<T>

Возвращает компаратор, задающий порядок, обратный порядку этого компаратора.

reverseOrder

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<T>> reverseOrder(): Comparator<T>

Возвращает компаратор, сравнивающий объекты Comparable в обратном естественном порядке.

then

Требования к платформе и версии: Common (1.0)

infix fun <T> Comparator<T>.then(comparator: Comparator<in T>): Comparator<T>

Объединяет этот компаратор с заданным компаратором так, что последний применяется только тогда, когда первый считает значения равными.

thenBy

Требования к платформе и версии: Common (1.0)

inline fun <T> Comparator<T>.thenBy(crossinline selector: (T) -> Comparable<*>?): Comparator<T>

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

inline fun <T, K> Comparator<T>.thenBy(comparator: Comparator<in K>, crossinline selector: (T) -> K): Comparator<T>

Создаёт компаратор для сравнения значений, признанных равными основным компаратором. Использует функцию selector для преобразования значений, а затем сравнивает их с помощью заданного компаратора.

thenByDescending

Требования к платформе и версии: Common (1.0)

inline fun <T> Comparator<T>.thenByDescending(crossinline selector: (T) -> Comparable<*>?): Comparator<T>

Создаёт компаратор с обратным порядком, используя основной компаратор и функцию для преобразования значения в экземпляр Comparable для сравнения.

inline fun <T, K> Comparator<T>.thenByDescending(comparator: Comparator<in K>, crossinline selector: (T) -> K): Comparator<T>

Создаёт компаратор с обратным порядком для сравнения значений, признанных равными основным компаратором. Использует функцию selector для преобразования значений, а затем сравнивает их с помощью заданного компаратора.

thenComparator

Требования к платформе и версии: Common (1.0)

inline fun <T> Comparator<T>.thenComparator(crossinline comparison: (a: T, b: T) -> Int): Comparator<T>

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

thenDescending

Требования к платформе и версии: Common (1.0)

infix fun <T> Comparator<T>.thenDescending(comparator: Comparator<in T>): Comparator<T>

Объединяет этот компаратор с заданным компаратором так, что последний применяется только тогда, когда первый считает значения равными.

© 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.comparisons/index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API