Диапазоны и прогрессии

Диапазон

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

Основной операцией над диапазонами является contains, которая обычно используется в форме операторов in и !in.

Чтобы создать диапазон для вашего класса, вызовите функцию rangeTo() для начального значения диапазона и передайте конечное значение в качестве аргумента. rangeTo() часто вызывается в операторной форме ...

class Version(val major: Int, val minor: Int): Comparable<Version> {
    override fun compareTo(other: Version): Int {
        if (this.major != other.major) {
            return this.major - other.major
        }
        return this.minor - other.minor
    }
}

fun main() {
//sampleStart
    val versionRange = Version(1, 11)..Version(1, 30)
    println(Version(0, 9) in versionRange)
    println(Version(1, 20) in versionRange)
//sampleEnd
}

Прогрессия

Как показано в примерах выше, диапазоны целочисленных типов, такие как Int, Long, и Char, могут рассматриваться как арифметические прогрессии соответствующих типов. В Kotlin эти прогрессии определяются специальными типами: IntProgression, LongProgression и CharProgression.

Прогрессии имеют три основных свойства: начальный элемент, конечный элемент и ненулевой шаг. Начальный элемент — first, последующие элементы — предыдущий элемент плюс шаг. Итерация по прогрессии с положительным шагом эквивалентна индексированному циклу for в Java/JavaScript.

for (int i = first; i <= last; i += step) {
  // ...
}

Когда вы неявно создаёте прогрессию, перебирая диапазон, начальный и конечный элементы этой прогрессии — это граничные значения диапазона, а шаг — 1.

fun main() {
//sampleStart
    for (i in 1..10) print(i)
//sampleEnd
}

Чтобы определить собственный шаг прогрессии, используйте функцию step для диапазона.

fun main() {
//sampleStart
    for (i in 1..8 step 2) print(i)
//sampleEnd
}

Конечный элемент прогрессии рассчитывается следующим образом:

• Для положительного шага: максимальное значение, не большее, чем конечное значение, такое, что (last - first) % step == 0.

• Для отрицательного шага: минимальное значение, не меньшее, чем конечное значение, такое, что (last - first) % step == 0.

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

fun main() {
//sampleStart
    for (i in 1..9 step 3) print(i) // the last element is 7
//sampleEnd
}

Для создания прогрессии для итерации в обратном порядке используйте downTo вместо .. при определении диапазона.

fun main() {
//sampleStart
    for (i in 4 downTo 1) print(i)
//sampleEnd
}

Если у вас уже есть прогрессия, вы можете перебрать её в обратном порядке с помощью функции reversed:

fun main() {
//sampleStart
    for (i in (1..4).reversed()) print(i)
//sampleEnd
}

Прогрессии реализуют Iterable<N>, где N это Int, Long, или Char соответственно, поэтому вы можете использовать их в различных функциях для коллекций, таких как map, filter, и других.

fun main() {
//sampleStart
    println((1..10).filter { it % 2 == 0 })
//sampleEnd
}