Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri