isSortedDescending

kotlin-stdlib/kotlin.collections/isSortedDescending

Начиная с Kotlin: 2.4

fun <T : Comparable<T>> Array<out T>.isSortedDescending(): Boolean

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

Возвращает true, если в массиве меньше двух элементов.

Элементы сравниваются последовательно с помощью Comparable.compareTo, и массив считается отсортированным по убыванию, если для каждой пары соседних элементов предшествующий элемент не меньше следующего.

Для элементов типов с плавающей точкой (Double, Float) NaN считается больше любого другого значения (включая положительную бесконечность), а -0.0 считается меньше 0.0, что согласуется с Double.compareTo и Float.compareTo.

Примеры


fun main() { 
   //sampleStart 
   println(arrayOf<String>().isSortedDescending()) // true
println(arrayOf("cherry").isSortedDescending()) // true

val sorted = arrayOf("cherry", "banana", "apple")
println(sorted.isSortedDescending()) // true

val unsorted = arrayOf("banana", "cherry", "apple")
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun ByteArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

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

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(byteArrayOf().isSortedDescending()) // true
println(byteArrayOf(5).isSortedDescending()) // true

val sorted = byteArrayOf(5, 4, 3, 2, 1)
println(sorted.isSortedDescending()) // true

val unsorted = byteArrayOf(4, 5, 3, 2, 1)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun ShortArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(shortArrayOf().isSortedDescending()) // true
println(shortArrayOf(5).isSortedDescending()) // true

val sorted = shortArrayOf(5, 4, 3, 2, 1)
println(sorted.isSortedDescending()) // true

val unsorted = shortArrayOf(4, 5, 3, 2, 1)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun IntArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(intArrayOf().isSortedDescending()) // true
println(intArrayOf(5).isSortedDescending()) // true

val sorted = intArrayOf(5, 4, 3, 2, 1)
println(sorted.isSortedDescending()) // true

val unsorted = intArrayOf(4, 5, 3, 2, 1)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun LongArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(longArrayOf().isSortedDescending()) // true
println(longArrayOf(5L).isSortedDescending()) // true

val sorted = longArrayOf(5L, 4L, 3L, 2L, 1L)
println(sorted.isSortedDescending()) // true

val unsorted = longArrayOf(4L, 5L, 3L, 2L, 1L)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun FloatArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Элементы сравниваются последовательно с помощью Float.compareTo, и массив считается отсортированным по убыванию, если для каждой пары соседних элементов предшествующий элемент не меньше следующего.

Для массивов с плавающей точкой NaN считается больше любого другого значения (включая положительную бесконечность), а -0.0 считается меньше 0.0, что согласуется с Float.compareTo.

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(floatArrayOf().isSortedDescending()) // true
println(floatArrayOf(3.14f).isSortedDescending()) // true

val sorted = floatArrayOf(3.14f, 2.5f, 1.0f)
println(sorted.isSortedDescending()) // true

val unsorted = floatArrayOf(2.5f, 3.14f, 1.0f)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun DoubleArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Элементы сравниваются последовательно с помощью Double.compareTo, и массив считается отсортированным по убыванию, если для каждой пары соседних элементов предшествующий элемент не меньше следующего.

Для массивов с плавающей точкой NaN считается больше любого другого значения (включая положительную бесконечность), а -0.0 считается меньше 0.0, что согласуется с Double.compareTo.

Примеры

import kotlin.math.abs

fun main() { 
   //sampleStart 
   println(doubleArrayOf().isSortedDescending()) // true
println(doubleArrayOf(3.14).isSortedDescending()) // true

val sorted = doubleArrayOf(3.14, 2.5, 1.0)
println(sorted.isSortedDescending()) // true

val unsorted = doubleArrayOf(2.5, 3.14, 1.0)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun BooleanArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(booleanArrayOf().isSortedDescending()) // true
println(booleanArrayOf(true).isSortedDescending()) // true

val sorted = booleanArrayOf(true, false, false)
println(sorted.isSortedDescending()) // true

val unsorted = booleanArrayOf(false, true, false)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun CharArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(charArrayOf().isSortedDescending()) // true
println(charArrayOf('c').isSortedDescending()) // true

val sorted = charArrayOf('c', 'b', 'a')
println(sorted.isSortedDescending()) // true

val unsorted = charArrayOf('b', 'c', 'a')
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}

fun <T : Comparable<T>> Iterable<T>.isSortedDescending(): Boolean

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

Возвращает true, если в коллекции меньше двух элементов.

Элементы сравниваются последовательно с помощью Comparable.compareTo, и коллекция считается отсортированной по убыванию, если для каждой пары соседних элементов предшествующий элемент не меньше следующего.

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

Примеры


fun main() { 
   //sampleStart 
   println(listOf<String>().isSortedDescending()) // true
println(listOf("cherry").isSortedDescending()) // true

val sorted = listOf("cherry", "banana", "apple")
println(sorted.isSortedDescending()) // true

val unsorted = listOf("banana", "cherry", "apple")
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}


@ExperimentalUnsignedTypes
fun UIntArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(uintArrayOf().isSortedDescending()) // true
println(uintArrayOf(5u).isSortedDescending()) // true

val sorted = uintArrayOf(5u, 4u, 3u, 2u, 1u)
println(sorted.isSortedDescending()) // true

val unsorted = uintArrayOf(4u, 5u, 3u, 2u, 1u)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}


@ExperimentalUnsignedTypes
fun ULongArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(ulongArrayOf().isSortedDescending()) // true
println(ulongArrayOf(5uL).isSortedDescending()) // true

val sorted = ulongArrayOf(5uL, 4uL, 3uL, 2uL, 1uL)
println(sorted.isSortedDescending()) // true

val unsorted = ulongArrayOf(4uL, 5uL, 3uL, 2uL, 1uL)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}


@ExperimentalUnsignedTypes
fun UByteArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(ubyteArrayOf().isSortedDescending()) // true
println(ubyteArrayOf(5u).isSortedDescending()) // true

val sorted = ubyteArrayOf(5u, 4u, 3u, 2u, 1u)
println(sorted.isSortedDescending()) // true

val unsorted = ubyteArrayOf(4u, 5u, 3u, 2u, 1u)
println(unsorted.isSortedDescending()) // false 
   //sampleEnd
}


@ExperimentalUnsignedTypes
fun UShortArray.isSortedDescending(): Boolean

Возвращает true, если в массиве меньше двух элементов.

Примеры


fun main() { 
   //sampleStart 
   println(ushortArrayOf().isSortedDescending()) // true
println(ushortArrayOf(5u).isSortedDescending()) // true

val sorted = ushortArrayOf(5u, 4u, 3u, 2u, 1u)
println(sorted.isSortedDescending()) // true

val unsorted = ushortArrayOf(4u, 5u, 3u, 2u, 1u)
println(unsorted.isSortedDescending()) // false 
   //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.collections/is-sorted-descending.html