CKTIS / C++
co_yield — posredovanje vrednosti iz korutine
Izraz co_yield posreduje operand funkciji yield_value objekta promise korutine in počaka na rezultat. V generatorju zaporedno omogoča dostop do vrednosti, ne da bi končal funkcijo; ali se izvajanje dejansko zaustavi, je odvisno od mehanizma čakanja.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_yield assignment-expression
co_yield braced-init-listco_yield je ključna beseda, ki tvori izraz za posredovanje vrednosti iz korutine. Pojavi se lahko samo v kontekstu funkcije, kjer je zaustavitev dovoljena. Operand je lahko prireditveni izraz ali inicializacijski seznam v zavitih oklepajih. To ni običajni return.
Za operand e in objekt promise p je co_yield e enakovreden izrazu co_await p.yield_value(e). Tip promise mora zato zagotavljati ustrezen yield_value, katerega rezultat podpira protokol čakanja. Sama ključna beseda ne zagotavlja zaustavitve: to vedenje določa dobljeni awaitable objekt.
V primeru std::generator<int> zaporedoma omogoča dostop do posameznih vrednosti. Zanka v main nadaljuje korutino, ki pri vsakem co_yield posreduje naslednjo vrednost in zaustavi izvajanje. Po nadaljevanju se izvajanje nadaljuje za tem izrazom. co_return pa pomeni konec korutine, ne posredovanja naslednjega elementa.
Primer zahteva prevajalnik in standardno knjižnico s podporo za C++23 in <generator>. Zastavica -std=c++23 sama po sebi ne dokazuje niti razpoložljivosti te knjižnice niti pripravljenosti izvajalnega okolja za produkcijo. Izvorno besedilo je razvijajoči se delovni osnutek, ne zamrznjeno besedilo C++23.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.