Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

co_yield — odovzdanie hodnoty z korutiny

Výraz co_yield odovzdá svoj operand funkcii yield_value objektu promise korutiny a počká na výsledok. V generátore postupne sprístupňuje ďalšie hodnoty bez ukončenia funkcie; či sa vykonávanie skutočne pozastaví, závisí od mechanizmu čakania.

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

Syntax

co_yield assignment-expression
co_yield braced-init-list

co_yield je kľúčové slovo, ktoré tvorí výraz odovzdávajúci hodnotu z korutiny. Môže sa vyskytovať iba v kontexte funkcie, kde je povolené pozastavenie. Operandom môže byť priraďovací výraz alebo inicializačný zoznam v zložených zátvorkách. Nie je to bežné return.

Pre operand e a objekt promise p je co_yield e ekvivalentné výrazu co_await p.yield_value(e). Typ promise preto musí poskytovať vhodnú funkciu yield_value, ktorej výsledok podporuje protokol čakania. Samotné kľúčové slovo pozastavenie nezaručuje: o tomto správaní rozhoduje výsledný awaitable objekt.

V príklade sprístupňuje std::generator<int> hodnoty postupne, jednu po druhej. Cyklus v main obnovuje korutinu, ktorá pri každom co_yield odovzdá ďalšiu hodnotu a pozastaví vykonávanie. Po obnovení pokračuje vykonávanie za týmto výrazom. Naproti tomu co_return znamená ukončenie korutiny, nie odovzdanie ďalšieho prvku.

Príklad vyžaduje kompilátor a štandardnú knižnicu s podporou C++23 a <generator>. Samotný prepínač -std=c++23 nedokazuje dostupnosť tejto knižnice ani pripravenosť runtime prostredia na produkčné použitie. Zdrojový text je priebežne upravovaný pracovný návrh, nie zmrazený text C++23.

Prí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ýsledok

10
20

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje