fun <T> buildIterator( builderAction: suspend SequenceBuilder<T>.() -> Unit ): Iterator<T>
Platform and version requirements: Kotlin 1.1
Builds an Iterator lazily yielding values one by one.
import kotlin.test.*
import kotlin.coroutines.experimental.buildIterator
import kotlin.coroutines.experimental.buildSequence
fun main(args: Array<String>) {
//sampleStart
val collection = listOf(1, 2, 3)
val wrappedCollection = object : AbstractCollection<Any>() {
override val size: Int = collection.size + 2
override fun iterator(): Iterator<Any> = buildIterator {
yield("first")
yieldAll(collection)
yield("last")
}
}
println(wrappedCollection) // [first, 1, 2, 3, last]
//sampleEnd
}
import kotlin.coroutines.experimental.buildIterator
import kotlin.test.*
fun main(args: Array<String>) {
//sampleStart
val iterable = Iterable {
buildIterator {
yield(42)
yieldAll(1..5 step 2)
}
}
val result = iterable.mapIndexed { index, value -> "$index: $value" }
println(result) // [0: 42, 1: 1, 2: 3, 3: 5]
// can be iterated many times
repeat(2) {
val sum = iterable.sum()
println(sum) // 51
}
//sampleEnd
}
© 2010–2018 JetBrains s.r.o.
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.coroutines.experimental/build-iterator.html