Generatoren

Jedes Mal coroutine.resume zu schreiben und das true aufzufangen, wird mühsam. Wenn du nur die Werte willst, die eine Koroutine mit yield abgibt, benutze coroutine.wrap. Es macht ebenfalls eine Koroutine, gibt dir aber eine Funktion zurück: Jeder Aufruf dieser Funktion setzt die Koroutine fort und gibt nur die Werte aus yield zurück, ohne das true:

-- Emmas Saatbeutel
local naechsteSaat = coroutine.wrap(function()
    coroutine.yield("Karotte")
    coroutine.yield("Kartoffel")
    coroutine.yield("Kürbis")
end)

print(naechsteSaat())
print(naechsteSaat())
print("Letzte Saat: " .. naechsteSaat())

Das gibt Folgendes aus:

Karotte
Kartoffel
Letzte Saat: Kürbis

Die Funktion für die Koroutine ist hier anonym und steht direkt in den Klammern, wie du es aus der Lektion über Funktionen kennst. Eine Funktion, die bei jedem Aufruf den nächsten Wert liefert, heißt Generator.

Generatoren in for. Einen hast du schon benutzt: for wort in text:gmatch("%a+") do aus der Lektion über Zeichenketten. gmatch gibt eine Funktion zurück, und for … in ruft sie vor jedem Durchlauf der Schleife auf. Was sie zurückgibt, geht in die Schleifenvariablen; gibt sie nil oder nichts zurück, endet die Schleife. Ein Generator aus coroutine.wrap passt genau hinein: Erreicht seine Funktion ihr Ende, gibt der Aufruf nichts zurück, und die Schleife hört auf.

Meistens schreibst du eine Funktion, die ein paar Einstellungen bekommt und einen neuen Generator zurückgibt. Dieser geht die Beete eines Feldes durch, Reihe für Reihe:

-- Jedes Beet des Feldes
local function beete(reihen, spalten)
    return coroutine.wrap(function()
        for reihe = 1, reihen do
            for spalte = 1, spalten do
                coroutine.yield(reihe, spalte)
            end
        end
    end)
end

for reihe, spalte in beete(2, 2) do
    print("Beet " .. reihe .. "-" .. spalte)
end

Das gibt Folgendes aus:

Beet 1-1
Beet 1-2
Beet 2-1
Beet 2-2

Die verschachtelten Schleifen sind im Generator versteckt, und die Schleife, die ihn benutzt, ist so einfach wie eine Schleife mit ipairs. Zwischen den Aufrufen merkt sich die Koroutine, wo sie in beiden Schleifen ist. Jeder Aufruf von beete(2, 2) erzeugt einen neuen Generator, der wieder bei Beet 1-1 beginnt.

Achtung:

• Ein Generator ist verbraucht, sobald seine Funktion zu Ende ist. Rufst du ihn noch einmal auf, stoppt das Programm mit cannot resume dead coroutine. Für eine weitere Runde erzeuge einen neuen Generator.
• Eine gewöhnliche Funktion mit yield darin, die nicht mit coroutine.wrap gemacht wurde, funktioniert in for nicht: Die Schleife führt sie als gewöhnliche Funktion aus, und ihr yield scheitert mit attempt to yield from outside a coroutine.
• Eine Koroutine aus coroutine.create ist keine Funktion, also funktioniert sie in for auch nicht: attempt to call a thread value. Für for benutze wrap.