Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

co_yield — producir un valor desde una corrutina

Una expresión co_yield pasa su operando a yield_value del objeto promise de la corrutina y espera el resultado. En un generador, ofrece valores sucesivos sin terminar la función; que la ejecución se suspenda realmente depende del mecanismo de espera.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

co_yield assignment-expression
co_yield braced-init-list

co_yield es una palabra clave que forma una expresión para producir un valor desde una corrutina. Solo puede aparecer en un contexto de función que permita la suspensión. Su operando puede ser una expresión de asignación o una lista de inicialización entre llaves. No es un return normal.

Para el operando e y el objeto promise p, co_yield e equivale a co_await p.yield_value(e). Por tanto, el tipo promise debe proporcionar un yield_value adecuado cuyo resultado admita el protocolo de espera. La palabra clave por sí sola no garantiza la suspensión: ese comportamiento lo determina el objeto awaitable resultante.

En el ejemplo, std::generator<int> ofrece los valores de uno en uno. El bucle de main reanuda la corrutina, que proporciona su siguiente valor y suspende la ejecución en cada co_yield. Al reanudarse, la ejecución continúa después de esa expresión. En cambio, co_return indica que la corrutina termina, no que se entrega otro elemento.

El ejemplo requiere un compilador y una biblioteca estándar compatibles con C++23 y <generator>. La opción -std=c++23 por sí sola no demuestra que la biblioteca esté disponible ni que el entorno de ejecución esté listo para producción. El texto fuente es un borrador de trabajo en evolución, no el texto definitivo e inmutable de C++23.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes