ByteIterator

kotlin-stdlib/kotlin.collections/ByteIterator

Начиная с Kotlin: 1.0

abstract class ByteIterator : Iterator<Byte>

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

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

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

class ByteContainer(private val data: ByteArray) {

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

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

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

for (element in ByteContainer(byteArrayOf(1, 2, 3))) {
    ... handle element ...
}

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

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

ByteIterator

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(): Byte

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

nextByte

Начиная с Kotlin: 1.0

abstract fun nextByte(): Byte

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

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/-byte-iterator/index.html