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

Диапазон

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

Основная операция над диапазонами — 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
}