WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen