downTo

Начиная с Kotlin: 1.0

infix fun Int.downTo(to: Byte): IntProgression

infix fun Long.downTo(to: Byte): LongProgression

infix fun Byte.downTo(to: Byte): IntProgression

infix fun Short.downTo(to: Byte): IntProgression

infix fun Char.downTo(to: Char): CharProgression

infix fun Int.downTo(to: Int): IntProgression

infix fun Long.downTo(to: Int): LongProgression

infix fun Byte.downTo(to: Int): IntProgression

infix fun Short.downTo(to: Int): IntProgression

infix fun Int.downTo(to: Long): LongProgression

infix fun Long.downTo(to: Long): LongProgression

infix fun Byte.downTo(to: Long): LongProgression

infix fun Short.downTo(to: Long): LongProgression

infix fun Int.downTo(to: Short): IntProgression

infix fun Long.downTo(to: Short): LongProgression

infix fun Byte.downTo(to: Short): IntProgression

infix fun Short.downTo(to: Short): IntProgression

Возвращает прогрессию от этого значения в обратном порядке до указанного значения to включительно с шагом -1.

Значение to должно быть меньше или равно значению this. Если значение to больше значения this, возвращаемая прогрессия будет пустой.

Примеры

import java.sql.Date
import kotlin.test.assertFalse
import kotlin.test.assertTrue

fun main() { 
   //sampleStart 
   val descendingProgression = 5 downTo 1
println(descendingProgression.toList()) // [5, 4, 3, 2, 1]
val singleElementProgression = 5 downTo 5
println(singleElementProgression.toList()) // [5]
val emptyProgression = 5 downTo 7
println(emptyProgression.toList()) // []

for (i in 3 downTo 0) {
    if (i > 0) println("$i...") else println("Launch!")
} 
   //sampleEnd
}

infix fun UByte.downTo(to: UByte): UIntProgression

infix fun UInt.downTo(to: UInt): UIntProgression

infix fun ULong.downTo(to: ULong): ULongProgression

infix fun UShort.downTo(to: UShort): UIntProgression

Возвращает прогрессию от этого значения в обратном порядке до указанного значения to включительно с шагом -1.

Примеры

import java.sql.Date
import kotlin.test.assertFalse
import kotlin.test.assertTrue

fun main() { 
   //sampleStart 
   val descendingProgression = 5 downTo 1
println(descendingProgression.toList()) // [5, 4, 3, 2, 1]
val singleElementProgression = 5 downTo 5
println(singleElementProgression.toList()) // [5]
val emptyProgression = 5 downTo 7
println(emptyProgression.toList()) // []

for (i in 3 downTo 0) {
    if (i > 0) println("$i...") else println("Launch!")
} 
   //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.ranges/down-to.html