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.