CKTIS / C++
co_yield — przekazywanie wartości z korutyny
Wyrażenie co_yield przekazuje operand do yield_value obiektu promise korutyny i oczekuje na otrzymany obiekt. W generatorze pozwala udostępniać kolejne wartości bez kończenia funkcji; rzeczywiste zawieszenie zależy od mechanizmu oczekiwania.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
co_yield assignment-expression
co_yield braced-init-listco_yield jest słowem kluczowym tworzącym wyrażenie przekazujące wartość z korutyny. Może wystąpić wyłącznie w kontekście dopuszczającym zawieszenie funkcji. Operand może być wyrażeniem przypisania albo listą inicjalizacyjną w klamrach. Nie jest to zwykły return.
Dla operandu e i obiektu promise p zapis co_yield e jest równoważny co_await p.yield_value(e). Typ promise musi więc zapewniać odpowiednie yield_value, którego wynik obsługuje protokół oczekiwania. Samo słowo kluczowe nie gwarantuje zawieszenia: decyduje o nim otrzymany obiekt oczekiwalny.
W przykładzie std::generator<int> udostępnia wartości kolejno. Pętla w main wznawia korutynę, która przy każdym co_yield przekazuje następną wartość i zawiesza wykonanie. Po wznowieniu wykonanie jest kontynuowane za tym wyrażeniem. co_return oznacza natomiast zakończenie korutyny, nie przekazanie kolejnego elementu.
Przykład wymaga kompilatora i biblioteki standardowej obsługujących C++23 oraz <generator>. Sama flaga -std=c++23 nie potwierdza dostępności tej biblioteki ani gotowości środowiska produkcyjnego. Źródło jest rozwijanym szkicem standardu, a nie zamrożonym tekstem C++23.
Przykłady
#include <generator>
#include <iostream>
std::generator<int> numbers() {
co_yield 10;
co_yield 20;
}
int main() {
for (int value : numbers()) {
std::cout << value << '\n';
}
}
Wynik
10 20
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.