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

CKTIS / C++

std::noop_coroutine — un handle vers une coroutine sans effet

std::noop_coroutine() renvoie un handle non nul vers une coroutine spéciale dont la reprise et la destruction n’ont aucun effet observable. Ce n’est pas un handle vide.

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

Syntaxe

#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;

std::noop_coroutine(), définie dans <coroutine>, est une fonction noexcept. Elle renvoie std::noop_coroutine_handle, un alias de std::coroutine_handle<std::noop_coroutine_promise>. Elle ne nécessite ni argument ni fonction coroutine écrite par l’utilisateur.

Le handle renvoyé n’est pas vide : sa conversion en bool donne true, address() est non nul et done() donne false. Les appels à resume(), operator() et destroy() n’ont aucun effet ; en particulier, destroy() n’invalide pas ce handle. Ces garanties ne s’appliquent pas aux handles de coroutine quelconques.

Le handle peut être converti en std::coroutine_handle<>. Même après cette conversion, la reprise et la destruction n’ont aucun effet observable. Ne supposez pas que les handles obtenus lors de deux appels distincts à std::noop_coroutine() sont égaux : la norme autorise les deux résultats de comparaison.

L’exemple vérifie l’état avant et après les opérations, y compris après la conversion en std::coroutine_handle<>. Il n’affiche aucune adresse et ne compare pas des appels distincts, ce qui rend la sortie attendue déterministe.

Exemples

#include <coroutine>
#include <iostream>

int main() {
    auto h = std::noop_coroutine();
    std::cout << std::boolalpha;
    std::cout << "valid=" << static_cast<bool>(h)
              << " done=" << h.done() << '\n';

    h.resume();
    h();
    h.destroy();

    std::coroutine_handle<> erased = h;
    erased.resume();
    erased.destroy();

    std::cout << "after: valid=" << static_cast<bool>(h)
              << " done=" << h.done() << '\n';
}

Résultat

valid=true done=false
after: valid=true done=false

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