CKTIS / C++
std::noop_coroutine — ročica do korutine brez učinka
std::noop_coroutine() vrne neprazno ročico do posebne korutine, katere nadaljevanje in uničenje nimata opaznih učinkov. To ni prazna ročica.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() iz <coroutine> je funkcija noexcept. Vrne std::noop_coroutine_handle, vzdevek za std::coroutine_handle<std::noop_coroutine_promise>. Ne potrebuje argumentov ali uporabniško napisane funkcije korutine.
Vrnjena ročica ni prazna: pretvorba v bool da true, address() ni ničelni in done() da false. Klici resume(), operator() in destroy() nimajo učinkov; zlasti destroy() te ročice ne razveljavi. Ta jamstva ne veljajo za poljubne ročice korutin.
Ročico je mogoče pretvoriti v std::coroutine_handle<>. Tudi po tej pretvorbi nadaljevanje in uničenje nimata opaznih učinkov. Ne predpostavljajte, da so ročice iz dveh ločenih klicev std::noop_coroutine() enake: standard dovoljuje oba rezultata primerjave.
Primer preveri stanje pred operacijami in po njih, tudi po pretvorbi v std::coroutine_handle<>. Ne izpisuje naslovov in ne primerja ločenih klicev, zato je pričakovani izpis determinističen.
Primeri
#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';
}
Rezultat
valid=true done=false after: valid=true done=false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.