CKTIS / C++
std::noop_coroutine — rukovatelj na korutinu bez učinka
std::noop_coroutine() vraća neprazan rukovatelj na posebnu korutinu čije nastavljanje i uništavanje nemaju vidljive učinke. To nije prazan rukovatelj.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() iz zaglavlja <coroutine> funkcija je noexcept. Vraća std::noop_coroutine_handle, alias za std::coroutine_handle<std::noop_coroutine_promise>. Ne zahtijeva argumente ni korisnički napisanu funkciju korutine.
Vraćeni rukovatelj nije prazan: pretvorba u bool daje true, address() nije nula, a done() daje false. Pozivi resume(), operator() i destroy() nemaju učinaka; posebno, destroy() ne poništava ovaj rukovatelj. Ta jamstva ne vrijede za proizvoljne rukovatelje korutina.
Rukovatelj se može pretvoriti u std::coroutine_handle<>. I nakon te pretvorbe, nastavljanje i uništavanje nemaju vidljive učinke. Nemojte pretpostaviti da su rukovatelji dobiveni iz dva odvojena poziva std::noop_coroutine() jednaki: standard dopušta oba rezultata usporedbe.
Primjer provjerava stanje prije i nakon operacija, uključujući nakon pretvorbe u std::coroutine_handle<>. Ne ispisuje adrese i ne uspoređuje odvojene pozive, pa je očekivani izlaz deterministički.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.