Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri