CKTIS / C++
co_yield — predavanje vrijednosti iz korutine
Izraz co_yield prosljeđuje svoj operand funkciji yield_value objekta promise korutine i čeka rezultat. U generatoru uzastopno izlaže vrijednosti bez završetka funkcije; hoće li se izvođenje doista suspendirati ovisi o mehanizmu čekanja.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_yield assignment-expression
co_yield braced-init-listco_yield je ključna riječ koja tvori izraz za predavanje vrijednosti iz korutine. Može se pojaviti samo u kontekstu funkcije u kojem je dopuštena suspenzija. Operand može biti izraz dodjele ili inicijalizacijski popis u vitičastim zagradama. To nije običan return.
Za operand e i objekt promise p, co_yield e ekvivalentan je izrazu co_await p.yield_value(e). Stoga tip promise mora pružati odgovarajući yield_value čiji rezultat podržava protokol čekanja. Sama ključna riječ ne jamči suspenziju: o tom ponašanju odlučuje dobiveni awaitable objekt.
U primjeru std::generator<int> izlaže vrijednosti jednu po jednu. Petlja u main nastavlja korutinu, koja pri svakom co_yield predaje sljedeću vrijednost i suspendira izvođenje. Nakon nastavka izvođenje se nastavlja iza tog izraza. Nasuprot tome, co_return znači završetak korutine, a ne predavanje sljedećeg elementa.
Primjer zahtijeva prevoditelj i standardnu biblioteku koji podržavaju C++23 i <generator>. Sama zastavica -std=c++23 ne potvrđuje dostupnost te biblioteke ni spremnost okruženja za izvršavanje u produkciji. Izvorni tekst razvojni je radni nacrt, a ne zamrznuti tekst C++23.
Primjeri
#include <generator>
#include <iostream>
std::generator<int> numbers() {
co_yield 10;
co_yield 20;
}
int main() {
for (int value : numbers()) {
std::cout << value << '\n';
}
}
Rezultat
10 20
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.