CKTIS / C++
std::noop_coroutine — ein Handle für eine Coroutine ohne Wirkung
std::noop_coroutine() gibt ein nicht leeres Handle auf eine spezielle Coroutine zurück, deren Fortsetzen und Zerstören keine beobachtbaren Auswirkungen hat. Es handelt sich nicht um ein leeres Handle.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() aus <coroutine> ist eine noexcept-Funktion. Sie gibt std::noop_coroutine_handle zurück, einen Alias für std::coroutine_handle<std::noop_coroutine_promise>. Die Funktion benötigt weder Argumente noch eine selbst geschriebene Coroutine-Funktion.
Das zurückgegebene Handle ist nicht leer: Die Umwandlung in bool ergibt true, address() ist ungleich null und done() ergibt false. Aufrufe von resume(), operator() und destroy() haben keine Auswirkungen; insbesondere macht destroy() dieses Handle nicht ungültig. Diese Garantien gelten nicht für beliebige Coroutine-Handles.
Das Handle kann in std::coroutine_handle<> umgewandelt werden. Auch nach dieser Umwandlung haben Fortsetzen und Zerstören keine beobachtbaren Auswirkungen. Gehe nicht davon aus, dass Handles aus zwei getrennten Aufrufen von std::noop_coroutine() gleich sind: Der Standard lässt beide Vergleichsergebnisse zu.
Das Beispiel prüft den Zustand vor und nach den Operationen, auch nach der Umwandlung in std::coroutine_handle<>. Es gibt keine Adressen aus und vergleicht keine getrennten Aufrufe, sodass die erwartete Ausgabe deterministisch ist.
Beispiele
#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';
}
Ergebnis
valid=true done=false after: valid=true done=false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.