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

Диапазон

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

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