FloatIterator

kotlin-stdlib/kotlin.collections/FloatIterator

Начиная с Kotlin: 1.0

abstract class FloatIterator : Iterator<Float>

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

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

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

class FloatContainer(private val data: FloatArray) {

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

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

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

for (element in FloatContainer(floatArrayOf(1f, 2f, 3f))) {
    ... handle element ...
}

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

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

FloatIterator

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

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

nextFloat

Начиная с Kotlin: 1.0

abstract fun nextFloat(): Float

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

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