CKTIS / C++
std::suspend_always — bezuvjetno suspendiranje korutine
std::suspend_always iz <coroutine> jednostavan je awaitable koji suspendira korutinu bez stvaranja vrijednosti. Ne zakazuje njezin nastavak: kod koji njome upravlja mora sačuvati handle te suspendiranu korutinu nastaviti ili uništiti.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <coroutine>
co_await std::suspend_always{};std::suspend_always iz <coroutine> implementira protokol awaiter. await_ready() vraća false, await_suspend(std::coroutine_handle<>) ne radi ništa i vraća void, a await_resume() također ne radi ništa i vraća void. Sve tri metode su constexpr, const i noexcept. Nasuprot tome, std::suspend_never iz await_ready() vraća true.
Kada je ovaj objekt stvarni awaiter, co_await std::suspend_always{}; suspendira korutinu i vraća kontrolu njezinu pozivatelju ili onome tko je nastavlja. Nakon nastavka izvršavanje se nastavlja bez dobivanja vrijednosti. Taj tip ne blokira nit, ne pokreće mjerač vremena i ne zakazuje nastavak. await_transform objekta promise ili preopterećeni operator co_await mogu promijeniti odabrani awaiter.
U primjeru initial_suspend() odgađa izvršavanje tijela do prvog resume(). Prvi nastavak ispisuje A i dolazi do izričite suspenzije; drugi ispisuje B i dolazi do final_suspend(). Destruktor vlasnika uništava sačuvani frame. Kopiranje vlasnika zabranjeno je kako bi se spriječilo dvostruko uništenje.
Nemojte nastaviti korutinu na njezinoj završnoj točki suspenzije niti koristiti handle nakon uništenja njezina framea. resume() u primjeru provjerava done() prije nastavka. Ovaj je zapis namijenjen prevođenju s -std=c++23; priloženi je dokument nacrt koji se i dalje razvija, a ne konačna objava C++23. Podršku prevoditelja i produkcijskog okruženja za izvođenje treba lokalno provjeriti.
Primjeri
#include <coroutine>
#include <exception>
#include <iostream>
struct Task {
struct promise_type {
Task get_return_object() {
return Task{std::coroutine_handle<promise_type>::from_promise(*this)};
}
std::suspend_always initial_suspend() noexcept { return {}; }
std::suspend_always final_suspend() noexcept { return {}; }
void return_void() noexcept {}
void unhandled_exception() { std::terminate(); }
};
std::coroutine_handle<promise_type> handle;
explicit Task(std::coroutine_handle<promise_type> h) : handle(h) {}
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
~Task() { handle.destroy(); }
void resume() {
if (!handle.done()) handle.resume();
}
};
Task work() {
std::cout << "A\n";
co_await std::suspend_always{};
std::cout << "B\n";
}
int main() {
auto task = work();
std::cout << "created\n";
task.resume();
std::cout << "paused\n";
task.resume();
std::cout << "finished\n";
}
Rezultat
created A paused B finished
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.