Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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-list

co_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.

Źródła