Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

co_yield — předání hodnoty z korutiny

Výraz co_yield předá svůj operand funkci yield_value objektu promise korutiny a vyčká na výsledek. V generátoru zpřístupňuje postupně další hodnoty, aniž by ukončil funkci; zda se provádění skutečně pozastaví, závisí na mechanismu čekání.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

co_yield assignment-expression
co_yield braced-init-list

co_yield je klíčové slovo, které tvoří výraz předávající hodnotu z korutiny. Může se objevit pouze v kontextu funkce, kde je povoleno pozastavení. Operandem může být přiřazovací výraz nebo seznam inicializátorů ve složených závorkách. Nejde o běžné return.

Pro operand e a objekt promise p je co_yield e ekvivalentní výrazu co_await p.yield_value(e). Typ promise proto musí poskytovat vhodnou funkci yield_value, jejíž výsledek podporuje protokol čekání. Samotné klíčové slovo pozastavení nezaručuje: o tomto chování rozhoduje výsledný awaitable objekt.

V příkladu zpřístupňuje std::generator<int> hodnoty postupně, jednu po druhé. Cyklus v main obnovuje korutinu, která při každém co_yield předá další hodnotu a pozastaví provádění. Po obnovení pokračuje provádění za tímto výrazem. Naproti tomu co_return znamená ukončení korutiny, nikoli předání dalšího prvku.

Příklad vyžaduje kompilátor a standardní knihovnu s podporou C++23 a <generator>. Samotný přepínač -std=c++23 nedokládá dostupnost této knihovny ani připravenost běhového prostředí pro produkční použití. Zdrojový text je průběžně upravovaný pracovní návrh, nikoli zmrazený text C++23.

Příklady

#include <generator>
#include <iostream>

std::generator<int> numbers() {
    co_yield 10;
    co_yield 20;
}

int main() {
    for (int value : numbers()) {
        std::cout << value << '\n';
    }
}

Výsledek

10
20

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje