CKTIS / C++
co_await — čekanje u korutini
Izraz co_await koristi protokol awaitera kako bi po potrebi obustavio korutinu i zatim dobio rezultat. Sam ne pokreće dretvu niti osigurava raspoređivanje; za nastavak mora biti zadužena upotrijebljena implementacija.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_await cast-expressionco_await expression označava moguću točku obustave korutine, a ne blokirajuće čekanje dretve. Uvrštavanje takvog izraza u tijelo funkcije čini je korutinom. Tip objekta promise određuje se preko std::coroutine_traits, koji mora pružiti odgovarajući promise_type za povratni tip i tipove parametara korutine (uključujući parametar objekta kod nestatičke članske funkcije). Sam povratni tip ne mora sadržavati ugniježđeni promise_type. Sam operator ne stvara ni dretvu ni raspoređivač.
Ako se pri izričitom co_await u tipu objekta promise pronađe deklaracija await_transform, awaitable je rezultat poziva await_transform na tom objektu s operandom kao argumentom. U suprotnom je awaitable izvorni operand. Ako se razrješavanjem preopterećenja za awaitable odabere operator co_await, rezultat poziva upotrebljava se kao awaiter. Sam awaitable upotrebljava se kao awaiter, nakon eventualne transformacije, samo ako je skup kandidata za operator co_await prazan. Ako skup nije prazan, ali ne sadrži nijednu primjenjivu funkciju, izraz co_await nije valjan. Awaiter pruža await_ready(), await_suspend(h) i await_resume(). Izraz ima tip i kategoriju vrijednosti rezultata funkcije await_resume().
Rezultat poziva await_ready() kontekstualno se pretvara u bool. Ako pretvorba daje true, korutina se ne obustavlja. To vrijedi i kada je rezultat objekt klasnog tipa čiji explicit operator bool() vraća true. Ako pretvorba daje false, korutina se obustavlja i poziva se await_suspend(h). Ako await_suspend ima povratni tip void, sam povratak iz poziva ne dovodi do toga da mehanizam co_await nastavi izvođenje korutine. Međutim, await_suspend može izravno nastaviti izvođenje korutine ili omogućiti da ga nastavi druga dretva, čak i prije povratka iz poziva. Rezultat tipa bool s vrijednošću false odmah nastavlja izvođenje korutine, a vraćanje ručice korutine prenosi izvođenje na navedenu korutinu. await_resume() daje rezultat kada se izvođenje nastavi.
Primjer upotrebljava std::suspend_always: run() ispisuje start i prepušta kontrolu; resume() joj omogućuje ispis resumed. final_suspend() ostavlja okvir obustavljenim kako bi ga destruktor od Task mogao osloboditi. Nikad ne nastavljajte korutinu na njezinoj završnoj točki obustave; objekti koji se koriste nakon nastavka moraju i dalje postojati.
Ovaj se unos odnosi na C++23; navedeno web-mjesto objavljuje nacrt koji se razvija, a ne nepromjenjivi tekst C++23. Kompatibilnost s produkcijskim izvršnim okruženjem nije potvrđena.
Primjeri
#include <coroutine>
#include <exception>
#include <iostream>
struct Task {
struct promise_type;
using Handle = std::coroutine_handle<promise_type>;
struct promise_type {
Task get_return_object() {
return Task{Handle::from_promise(*this)};
}
std::suspend_never initial_suspend() noexcept { return {}; }
std::suspend_always final_suspend() noexcept { return {}; }
void return_void() noexcept {}
void unhandled_exception() noexcept { std::terminate(); }
};
Handle handle;
explicit Task(Handle h) noexcept : handle(h) {}
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
~Task() { handle.destroy(); }
};
Task run() {
std::cout << "start\n";
co_await std::suspend_always{};
std::cout << "resumed\n";
}
int main() {
auto task = run();
std::cout << "caller\n";
task.handle.resume();
}
Rezultat
start caller resumed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.