IntIterator

kotlin-stdlib/kotlin.collections/IntIterator

Начиная с Kotlin: 1.0

abstract class IntIterator : Iterator<Int>

Итератор последовательности значений типа Int.

Это замена для Iterator<Int>, предоставляющая специализированную версию метода next(): T: nextInt(): Int. Компилятор обрабатывает её особым образом, чтобы в качестве оптимизации производительности избежать зависящих от платформы преобразований с упаковкой.

В следующем примере:

class IntContainer(private val data: IntArray) {

    // IntIterator instead of Iterator<Int> in the signature
    operator fun iterator(): IntIterator = object : IntIterator() {
        private var idx = 0

        override fun nextInt(): Int {
            if (!hasNext()) throw NoSuchElementException()
            return data[idx++]
        }

        override fun hasNext(): Boolean = idx < data.size
    }
}

for (element in IntContainer(intArrayOf(1, 2, 3))) {
    ... handle element ...
}

Во время итерации цикла for преобразование с упаковкой не выполняется. Обратите внимание: сам итератор всё равно будет выделен.

Конструкторы

IntIterator

constructor()

Функции

asSequence

Начиная с Kotlin: 1.0

fun <T> Iterator<T>.asSequence(): Sequence<T>

Создаёт последовательность, возвращающую все элементы этого итератора. Последовательность можно перебирать только один раз.

forEach

Начиная с Kotlin: 1.0

inline fun <T> Iterator<T>.forEach(operation: (T) -> Unit)

Выполняет заданную операцию для каждого элемента этого итератора.

hasNext

Начиная с Kotlin: 1.0

expect abstract operator fun hasNext(): Boolean

Возвращает true, если в итерации есть ещё элементы.

iterator

Начиная с Kotlin: 1.0

inline operator fun <T> Iterator<T>.iterator(): Iterator<T>

Возвращает переданный итератор без изменений. Это позволяет использовать экземпляр итератора в цикле for.

Начиная с Kotlin: 1.0

operator override fun next(): Int

Возвращает следующий элемент итерации.

nextInt

Начиная с Kotlin: 1.0

abstract fun nextInt(): Int

Возвращает следующий элемент итерации без преобразования с упаковкой.

withIndex

Начиная с Kotlin: 1.0

fun <T> Iterator<T>.withIndex(): Iterator<IndexedValue<T>>

Возвращает итератор, который оборачивает каждый элемент, созданный исходным итератором, в IndexedValue, содержащий индекс этого элемента и сам элемент.

© 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.collections/-int-iterator/index.html