Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::noop_coroutine — handle na korutínu bez účinku

std::noop_coroutine() vracia neprázdny handle na špeciálnu korutínu, ktorej obnovenie a zničenie nemá pozorovateľné účinky. Nie je to prázdny handle.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;

std::noop_coroutine() z <coroutine> je funkcia noexcept. Vracia std::noop_coroutine_handle, alias pre std::coroutine_handle<std::noop_coroutine_promise>. Nevyžaduje argumenty ani používateľom napísanú korutinovú funkciu.

Vrátený handle nie je prázdny: prevod na bool dáva true, address() nie je nulová a done() dáva false. Volania resume(), operator() a destroy() nemajú žiadne účinky; najmä destroy() tento handle nezneplatní. Tieto záruky neplatia pre ľubovoľné handle na korutínu.

Handle možno previesť na std::coroutine_handle<>. Ani po tomto prevode nemá obnovenie a zničenie žiadne pozorovateľné účinky. Nepredpokladajte, že handle získané dvoma samostatnými volaniami std::noop_coroutine() sú rovnaké: štandard povoľuje oba výsledky porovnania.

Príklad kontroluje stav pred operáciami aj po nich vrátane prevodu na std::coroutine_handle<>. Nevypisuje adresy ani neporovnáva samostatné volania, takže očakávaný výstup je deterministický.

Prí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ýsledok

valid=true done=false
after: valid=true done=false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje