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.