Spec-Zone.ru › Kotlin 1.8

Comparator

kotlin-stdlib / kotlin / Comparator
Требования к платформе и версии: JS (1.1), Native (1.3)
fun interface Comparator<T>
Требования к платформе и версии: JVM (1.1)
typealias Comparator<T> = Comparator<T>

Предоставляет функцию сравнения для задания полного упорядочения между экземплярами типа T.

Функции

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

compare

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

abstract fun compare(a: T, b: T): Int

Расширяющие функции

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

reversed

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

fun <T> Comparator<T>.reversed(): Comparator<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

then

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

infix fun <T> Comparator<T>.then(
    comparator: Comparator<in T>
): Comparator<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

thenBy

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

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

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

fun <T, K> Comparator<T>.thenBy(
    comparator: Comparator<in K>, 
    selector: (T) -> K
): Comparator<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

thenByDescending

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

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

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

fun <T, K> Comparator<T>.thenByDescending(
    comparator: Comparator<in K>, 
    selector: (T) -> K
): Comparator<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

thenComparator

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

fun <T> Comparator<T>.thenComparator(
    comparison: (a: T, b: T) -> Int
): Comparator<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

thenDescending

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

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

© 2010–2020 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-comparator/index.html

Spec-Zone.ru

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