CKTIS / C++
std::noop_coroutine — handle na korutinu bez účinku
std::noop_coroutine() vrací neprázdný handle ke speciální korutině, jejíž obnovení a zničení nemá pozorovatelné účinky. Nejde o prázdný handle.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() z <coroutine> je funkce noexcept. Vrací std::noop_coroutine_handle, alias pro std::coroutine_handle<std::noop_coroutine_promise>. Nevyžaduje argumenty ani uživatelem napsanou korutinovou funkci.
Vrácený handle není prázdný: převod na bool dává true, address() není nulová a done() dává false. Volání resume(), operator() a destroy() nemají žádné účinky; zejména destroy() tento handle nezneplatní. Tyto záruky neplatí pro libovolné handle ke korutině.
Handle lze převést na std::coroutine_handle<>. Ani po tomto převodu nemá obnovení a zničení žádné pozorovatelné účinky. Nepředpokládejte, že handle získané dvěma samostatnými voláními std::noop_coroutine() jsou stejná: standard připouští oba výsledky porovnání.
Příklad kontroluje stav před operacemi i po nich, včetně převodu na std::coroutine_handle<>. Nevypisuje adresy ani neporovnává samostatná volání, takže očekávaný výstup je deterministický.
Příklady
#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';
}
Výsledek
valid=true done=false after: valid=true done=false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.