`sequence` în Kotlin

Secvențe (Sequence) Kotlin 1.3

Construiește o secvență dintr-un bloc de cod care dă valori una câte una cu yield; codul se oprește și continuă la cerere.

Sintaxă

fun <T> sequence(bloc: suspend SequenceScope<T>.() -> Unit): Sequence<T>

// în bloc:
yield(valoare)
yieldAll(colectie)

Ce face `sequence`

În blocul sequence { ... } scrii cod obișnuit (bucle, if-uri), iar fiecare yield(x) „dă” un element. Blocul nu rulează dintr-odată: rulează până la primul yield, apoi se oprește și așteaptă până când cineva cere următorul element.

Așa poți scrie generatoare complicate (șiruri de numere, combinații, parcurgeri) fără să le ții pe toate în memorie. yieldAll(lista) dă toate elementele unei colecții sau ale altei secvențe.

Blocul poate fi infinit (de exemplu while (true)), cu aceeași regulă ca la generateSequence: iei doar cât îți trebuie.

Parametri

Parametru	Descriere
`bloc`	Codul care produce elementele cu `yield` și `yieldAll`.

Ce returnează

O Sequence<T>.

Exemple

Exemplul 1: Șirul lui Fibonacci

Bucla este infinită, dar luăm doar primele 10 numere. Fiecare yield oprește blocul până la cererea următoare.

fun main() {
    val fibonacci = sequence {
        var a = 0
        var b = 1
        while (true) {
            yield(a)
            val c = a + b
            a = b
            b = c
        }
    }
    println(fibonacci.take(10).toList())
}

Rezultat

[0, 1, 1, 2, 3, 5, 8, 13, 21, 34]

Exemplul 2: Orarul unei zile

Amestecăm yield și yieldAll. Mesajul „pregătesc pauza” apare abia când se cere elementul de după ore.

fun main() {
    val program = sequence {
        yield("08:00 Matematică")
        yieldAll(listOf("09:00 Română", "10:00 Istorie"))
        println("  (pregătesc pauza)")
        yield("11:00 Pauză mare")
        yield("11:30 Fizică")
    }
    println(program.take(2).toList())
    println("---")
    program.forEach { println(it) }
}