Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

co_yield — produrre un valore da una coroutine

Un’espressione co_yield passa il proprio operando a yield_value dell’oggetto promise della coroutine e attende il risultato. In un generatore, rende disponibili valori successivi senza terminare la funzione; l’effettiva sospensione dell’esecuzione dipende dal meccanismo di attesa.

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

Sintassi

co_yield assignment-expression
co_yield braced-init-list

co_yield è una parola chiave che forma un’espressione per produrre un valore da una coroutine. Può comparire solo in un contesto di funzione in cui sia consentita la sospensione. Il suo operando può essere un’espressione di assegnazione oppure una lista di inizializzazione tra parentesi graffe. Non è un normale return.

Per l’operando e e l’oggetto promise p, co_yield e equivale a co_await p.yield_value(e). Il tipo promise deve quindi fornire un yield_value adeguato, il cui risultato supporti il protocollo di attesa. La parola chiave, da sola, non garantisce la sospensione: il comportamento dipende dall’oggetto awaitable risultante.

Nell’esempio, std::generator<int> rende disponibili i valori uno alla volta. Il ciclo in main riprende la coroutine, che fornisce il valore successivo e sospende l’esecuzione a ogni co_yield. Quando viene ripresa, l’esecuzione continua dopo quell’espressione. co_return, invece, indica la conclusione della coroutine, non la produzione di un altro elemento.

L’esempio richiede un compilatore e una libreria standard che supportino C++23 e <generator>. La sola opzione -std=c++23 non dimostra né la disponibilità di questa libreria né la preparazione dell’ambiente di esecuzione per la produzione. Il testo sorgente è una bozza di lavoro in evoluzione, non il testo C++23 congelato.

Esempi

#include <generator>
#include <iostream>

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

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

Risultato

10
20

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti