Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori