CKTIS / C++
co_yield — einen Wert aus einer Koroutine liefern
Ein co_yield-Ausdruck übergibt seinen Operanden an yield_value des Promise-Objekts der Koroutine und erwartet das Ergebnis. In einem Generator stellt er nacheinander Werte bereit, ohne die Funktion zu beenden; ob die Ausführung tatsächlich angehalten wird, hängt vom Await-Mechanismus ab.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
co_yield assignment-expression
co_yield braced-init-listco_yield ist ein Schlüsselwort, das einen Ausdruck bildet, mit dem ein Wert aus einer Koroutine geliefert wird. Es darf nur in einem Funktionskontext verwendet werden, in dem Anhalten möglich ist. Als Operand sind ein Zuweisungsausdruck oder eine geklammerte Initialisierungsliste zulässig. Es handelt sich nicht um ein gewöhnliches return.
Für den Operanden e und das Promise-Objekt p ist co_yield e gleichbedeutend mit co_await p.yield_value(e). Der Promise-Typ muss daher ein geeignetes yield_value bereitstellen, dessen Ergebnis das Await-Protokoll unterstützt. Das Schlüsselwort allein garantiert kein Anhalten: Dieses Verhalten wird durch das resultierende Awaitable bestimmt.
Im Beispiel stellt std::generator<int> die Werte nacheinander bereit. Die Schleife in main setzt die Koroutine fort, die bei jedem co_yield ihren nächsten Wert liefert und die Ausführung anhält. Nach dem Fortsetzen wird die Ausführung hinter diesem Ausdruck weitergeführt. co_return bedeutet dagegen, dass die Koroutine beendet wird, nicht dass ein weiteres Element geliefert wird.
Das Beispiel erfordert einen Compiler und eine Standardbibliothek mit Unterstützung für C++23 und <generator>. Das Flag -std=c++23 allein belegt weder die Verfügbarkeit dieser Bibliothek noch die Produktionsreife der Laufzeitumgebung. Der Quelltext ist ein fortlaufend weiterentwickelter Arbeitsentwurf und nicht der eingefrorene C++23-Text.
Beispiele
#include <generator>
#include <iostream>
std::generator<int> numbers() {
co_yield 10;
co_yield 20;
}
int main() {
for (int value : numbers()) {
std::cout << value << '\n';
}
}
Ergebnis
10 20
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.