Функция rangeUntil

Функция rangeUntil создает объект диапазона от начального значения до конечного значения, исключая конечное значение. Применяется к числам типа Int, Long, Char и другим сравниваемым типам. Диапазон является полуоткрытым [start, end) - включает начальное значение, но исключает конечное.

Синтаксис

kotlin// Для Int
fun Int.rangeUntil(to: Int): IntRange

// Для Long
fun Long.rangeUntil(to: Long): LongRange

// Для Char
fun Char.rangeUntil(to: Char): CharRange

Пример

Создадим диапазон целых чисел от 1 до 5 (исключая 5):

kotlinval range = 1.rangeUntil(5)
println(range)

Результат выполнения кода:

kotlinIntRange 1..4

Пример

Использование диапазона в цикле for:

kotlinfor (i in 1.rangeUntil(5)) {
  print("$i ")
}

Результат выполнения кода:

kotlin1 2 3 4

Пример

Создадим диапазон символов от 'a' до 'e' (исключая 'e'):

kotlinval charRange = 'a'.rangeUntil('e')
println(charRange.toList())

Результат выполнения кода:

kotlin['a', 'b', 'c', 'd']

Пример

Создадим диапазон чисел типа Long:

kotlinval longRange = 10L.rangeUntil(15L)
println(longRange)

Результат выполнения кода:

kotlinLongRange 10..14

Пример

Проверка вхождения числа в диапазон:

kotlinval range = 5.rangeUntil(10)
val number = 7

if (number in range) {
  println("$number is in range")
} else {
  println("$number is not in range")
}

Результат выполнения кода:

kotlin7 is in range

Смотрите также

  • функцию rangeTo,
    которая создает диапазон включая конечное значение
  • функцию downTo,
    которая создает диапазон в обратном порядке
  • функцию coerceIn,
    которая ограничивает значение указанным диапазоном
  • функцию coerceAtLeast,
    которая возвращает значение не меньше указанного