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

CKTIS / C++

std::suspend_never — čakanje brez prekinitve izvajanja korutine

std::suspend_never iz <coroutine> je preprost awaiter, ki korutine ne prekine in ne vrne nobene vrednosti. Z njim lahko določimo takojšnji začetek ali zaključek korutine; ob zaključku moramo pozorno spremljati življenjsko dobo njenega stanja.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <coroutine>
co_await std::suspend_never{};

std::suspend_never je tip iz <coroutine>, katerega objekti lahko neposredno delujejo kot awaiterji za co_await. Korutine ne prekine in ne vrne nobene vrednosti: tip rezultata je void. Nasprotno pa std::suspend_always pri neposredni uporabi kot awaiter korutino vedno prekine.

await_ready() vrne true, zato protokol čakanja preskoči await_suspend(std::coroutine_handle<>) in pokliče await_resume(). Zadnji dve funkciji ne naredita ničesar in vrneta void; vse tri so constexpr, const in noexcept. Tako preprečimo prekinitev na tej konkretni točki, ne pa med celotno korutino. Prilagojeni await_transform objekta promise lahko spremeni razlago operanda co_await.

Implicitna izraza co_await za initial_suspend() in final_suspend() preskočita await_transform, vendar lahko vseeno izbereta preobloženi operator co_await, ki vrne awaiter, ki prekine izvajanje korutine. Sam tip vrnjene vrednosti torej ne zagotavlja, da do prekinitve ne bo prišlo. Če je objekt std::suspend_never, ki ga vrne initial_suspend(), sam uporabljen kot awaiter, se izvajanje takoj nadaljuje v telesu korutine. Če je objekt, ki ga vrne final_suspend(), sam uporabljen kot awaiter, končne prekinitve ni in stanje korutine se ob zaključku uniči. Vsak shranjeni ročaj do tega stanja postane neveljaven — prek njega pozneje ne smemo klicati resume(), done() ali destroy().

V primeru immediate_task ne shrani nobenega ročaja. run() izvede oba izpisa, preden se vrne v main(), njegovo stanje pa se samodejno počisti. Zapis se nanaša na C++23; navedeno spletišče vsebuje razvijajoči se osnutek standarda, ne nespremenjene izdaje C++23. Izvajanje v produkcijskem okolju ni bilo potrjeno.

Primeri

#include <coroutine>
#include <exception>
#include <iostream>

struct immediate_task {
    struct promise_type {
        immediate_task get_return_object() noexcept { return {}; }
        std::suspend_never initial_suspend() noexcept { return {}; }
        std::suspend_never final_suspend() noexcept { return {}; }
        void return_void() noexcept {}
        void unhandled_exception() noexcept { std::terminate(); }
    };
};

immediate_task run() {
    std::cout << "before\n";
    co_await std::suspend_never{};
    std::cout << "after\n";
    co_return;
}

int main() {
    run();
    std::cout << "returned\n";
}

Rezultat

before
after
returned

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri