CKTIS / C++
std::noop_coroutine — een handle naar een coroutine zonder effect
std::noop_coroutine() geeft een niet-lege handle naar een speciale coroutine terug waarvan hervatten en vernietigen geen waarneembare effecten hebben. Het is geen lege handle.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() uit <coroutine> is een noexcept-functie. De functie geeft std::noop_coroutine_handle terug, een alias voor std::coroutine_handle<std::noop_coroutine_promise>. Er zijn geen argumenten of een zelfgeschreven coroutinefunctie nodig.
De teruggegeven handle is niet leeg: conversie naar bool levert true op, address() is niet null en done() levert false op. Aanroepen van resume(), operator() en destroy() hebben geen effect; met name maakt destroy() deze handle niet ongeldig. Deze garanties gelden niet voor willekeurige coroutinehandles.
De handle kan worden geconverteerd naar std::coroutine_handle<>. Ook na deze conversie hebben hervatten en vernietigen geen waarneembare effecten. Ga er niet van uit dat handles uit twee afzonderlijke aanroepen van std::noop_coroutine() gelijk zijn: de standaard staat beide vergelijkingsresultaten toe.
Het voorbeeld controleert de status vóór en na de bewerkingen, ook na conversie naar std::coroutine_handle<>. Het drukt geen adressen af en vergelijkt geen afzonderlijke aanroepen, zodat de verwachte uitvoer deterministisch is.
Voorbeelden
#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';
}
Resultaat
valid=true done=false after: valid=true done=false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.