Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

co_yield — produzir um valor a partir de uma coroutine

Uma expressão co_yield passa o seu operando para yield_value do objeto promise da coroutine e aguarda o resultado. Num gerador, disponibiliza valores sucessivos sem terminar a função; a suspensão efetiva da execução depende do mecanismo de espera.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

co_yield assignment-expression
co_yield braced-init-list

co_yield é uma palavra-chave que forma uma expressão para produzir um valor a partir de uma coroutine. Só pode surgir num contexto de função em que a suspensão seja permitida. O operando pode ser uma expressão de atribuição ou uma lista de inicialização entre chavetas. Não é um return normal.

Para o operando e e o objeto promise p, co_yield e equivale a co_await p.yield_value(e). Por conseguinte, o tipo promise tem de fornecer um yield_value adequado, cujo resultado suporte o protocolo de espera. A palavra-chave, por si só, não garante a suspensão: esse comportamento é determinado pelo objeto awaitable resultante.

No exemplo, std::generator<int> disponibiliza os valores um de cada vez. O ciclo em main retoma a coroutine, que fornece o valor seguinte e suspende a execução em cada co_yield. Quando é retomada, a execução continua depois dessa expressão. Em contrapartida, co_return significa que a coroutine termina, não que é fornecido outro elemento.

O exemplo requer um compilador e uma biblioteca padrão com suporte para C++23 e <generator>. A opção -std=c++23, por si só, não comprova a disponibilidade desta biblioteca nem a preparação do ambiente de execução para produção. O texto-fonte é um rascunho de trabalho em evolução, não o texto C++23 fixado.

Exemplos

#include <generator>
#include <iostream>

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

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

Resultado

10
20

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes