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.