CKTIS / C++
co_yield — een waarde uit een coroutine leveren
Een co_yield-expressie geeft de operand door aan yield_value van het promise-object van de coroutine en wacht op het resultaat. In een generator maakt dit opeenvolgende waarden beschikbaar zonder de functie te beëindigen; of de uitvoering daadwerkelijk wordt opgeschort, hangt af van het await-mechanisme.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
co_yield assignment-expression
co_yield braced-init-listco_yield is een sleutelwoord dat een expressie vormt waarmee een waarde uit een coroutine wordt geleverd. Het mag alleen voorkomen in een functiecontext waarin opschorting is toegestaan. De operand kan een toewijzingsexpressie of een initialisatielijst tussen accolades zijn. Het is geen gewone return.
Voor operand e en promise-object p is co_yield e gelijk aan co_await p.yield_value(e). Het promise-type moet daarom een geschikte yield_value bieden waarvan het resultaat het await-protocol ondersteunt. Het sleutelwoord garandeert op zichzelf geen opschorting: het resulterende awaitable bepaalt dat gedrag.
In het voorbeeld maakt std::generator<int> de waarden één voor één beschikbaar. De lus in main hervat de coroutine, die bij elke co_yield de volgende waarde levert en de uitvoering opschort. Na hervatting gaat de uitvoering verder na die expressie. co_return betekent daarentegen dat de coroutine wordt beëindigd, niet dat er nog een element wordt geleverd.
Het voorbeeld vereist een compiler en standaardbibliotheek die C++23 en <generator> ondersteunen. Alleen de optie -std=c++23 bewijst niet dat deze bibliotheek beschikbaar is of dat de runtime-omgeving productierijp is. De brontekst is een voortdurend bijgewerkt werkdocument, niet de vastgestelde C++23-tekst.
Voorbeelden
#include <generator>
#include <iostream>
std::generator<int> numbers() {
co_yield 10;
co_yield 20;
}
int main() {
for (int value : numbers()) {
std::cout << value << '\n';
}
}
Resultaat
10 20
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.