Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje