Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

co_yield — produire une valeur depuis une coroutine

Une expression co_yield transmet son opérande au yield_value de l’objet promise de la coroutine, puis attend le résultat. Dans un générateur, elle expose des valeurs successives sans terminer la fonction ; la suspension effective de l’exécution dépend du mécanisme d’attente.

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

Syntaxe

co_yield assignment-expression
co_yield braced-init-list

co_yield est un mot-clé qui forme une expression permettant de produire une valeur depuis une coroutine. Il ne peut apparaître que dans un contexte de fonction où la suspension est autorisée. Son opérande peut être une expression d’affectation ou une liste d’initialisation entre accolades. Ce n’est pas un return ordinaire.

Pour l’opérande e et l’objet promise p, co_yield e équivaut à co_await p.yield_value(e). Le type promise doit donc fournir un yield_value adapté, dont le résultat prend en charge le protocole d’attente. Le mot-clé, à lui seul, ne garantit pas la suspension : celle-ci dépend de l’objet awaitable obtenu.

Dans l’exemple, std::generator<int> expose les valeurs une par une. La boucle de main reprend la coroutine, qui fournit sa valeur suivante et se suspend à chaque co_yield. Lorsqu’elle reprend, l’exécution continue après cette expression. En revanche, co_return signifie que la coroutine se termine, et non qu’elle fournit un élément supplémentaire.

L’exemple nécessite un compilateur et une bibliothèque standard prenant en charge C++23 et <generator>. Le seul indicateur -std=c++23 ne prouve ni la disponibilité de cette bibliothèque ni que l’environnement d’exécution est prêt pour la production. Le texte source est un projet de travail en évolution, et non le texte C++23 figé.

Exemples

#include <generator>
#include <iostream>

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

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

Résultat

10
20

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources