CKTIS / C++
std::suspend_never — čekanje bez obustavljanja korutine
std::suspend_never iz <coroutine> jednostavan je awaiter koji ne obustavlja korutinu i ne daje vrijednost. Omogućuje određivanje trenutačnog pokretanja ili dovršetka korutine; pri dovršetku treba pažljivo paziti na životni vijek njezina stanja.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <coroutine>
co_await std::suspend_never{};std::suspend_never tip je iz <coroutine> čiji objekti mogu izravno služiti kao awaiteri za co_await. Ne obustavlja korutinu i ne daje vrijednost: tip rezultata je void. Nasuprot tome, std::suspend_always pri izravnoj uporabi kao awaiter uvijek obustavlja korutinu.
await_ready() vraća true, pa await protokol preskače await_suspend(std::coroutine_handle<>) i poziva await_resume(). Posljednje dvije funkcije ne rade ništa i vraćaju void; sve tri su constexpr, const i noexcept. Time se sprječava obustava na toj konkretnoj točki, a ne tijekom cijele korutine. Prilagođeni await_transform objekta promise može promijeniti tumačenje operanda co_await.
Implicitni izrazi co_await za initial_suspend() i final_suspend() preskaču await_transform, ali ipak mogu odabrati preopterećeni operator co_await koji daje awaiter koji obustavlja korutinu. Sam povratni tip stoga ne jamči da neće doći do obustave. Ako objekt std::suspend_never koji vrati initial_suspend() sam služi kao awaiter, izvršavanje odmah prelazi u tijelo korutine. Ako objekt koji vrati final_suspend() sam služi kao awaiter, nema završne obustave i stanje korutine uništava se po dovršetku. Svaki zadržani handle na to stanje postaje nevaljan — nakon toga preko njega ne smijete pozivati resume(), done() ni destroy().
U primjeru immediate_task ne pohranjuje handle. run() izvršava oba ispisa prije povratka u main(), a njezino se stanje automatski čisti. Ovaj se zapis odnosi na C++23; navedeno web-mjesto sadrži nacrt standarda koji se razvija, a ne nepromjenjivu objavu C++23. Izvršavanje u produkcijskom okruženju nije potvrđeno.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.