CKTIS / C++
Korutine
Korutina može obustaviti izvođenje i kasnije ga nastaviti, pritom čuvajući potrebno stanje. Ključne riječi co_await, co_yield i co_return surađuju s tipom promise i ručkom korutine; ne pokreću automatski dretvu ni raspoređivač.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_await expression; co_yield expression; co_return [expression];Korutina je funkcija čije tijelo sadrži co_await, co_yield ili co_return. Pri obustavi čuva stanje potrebno za nastavak. Upravljanje se može vratiti onome tko je korutinu pozvao ili nastavio, ali ako await_suspend() awaitera vrati ručku druge korutine, upravljanje se predaje izravno toj korutini. To ne znači automatsko paralelno izvođenje: sama korutina ne stvara ni dretvu ni raspoređivač.
co_await koristi protokol awaitera: await_ready() provjerava je li rezultat spreman, await_suspend() obrađuje obustavu, a await_resume() daje rezultat. Ne ostavlja svaki co_await korutinu doista obustavljenom. co_yield value čeka rezultat izraza promise.yield_value(value) bez primjene await_transform objekta promise. Izričito napisan izraz co_await promise.yield_value(value) koristi await_transform ako ga tip promise pruža. Zamjena stoga može promijeniti ponašanje ili uzrokovati pogrešku pri prevođenju. co_return završava tijelo korutine umjesto da vrijednost izravno proslijedi pozivatelju.
Tip promise, obično dostupan kao promise_type povratnog tipa, određuje, među ostalim, objekt rezultata, početnu i završnu obustavu, dovršetak i obradu iznimki. <coroutine> pruža std::coroutine_handle i std::suspend_always. Ručka sama ne upravlja životnim vijekom stanja: odgovornost za njegovo uništavanje mora biti izričita.
U primjeru je Task vlasnik koji se ne može kopirati ni premještati. initial_suspend() odgađa izvođenje tijela, a final_suspend() zadržava stanje kako bi ga uništio destruktor. std::suspend_always iz primjera ne predaje upravljanje izravno drugoj korutini. Dva nastavljanja ispisuju 1 i 2; treće ne radi ništa zahvaljujući done(). Nastavljanje dovršene ili neobustavljene korutine uzrokuje nedefinirano ponašanje. Nakon uništenja stanja korutine, pokušaj nastavka preko ručke koja upućuje na to stanje također uzrokuje nedefinirano ponašanje. Poništavanje te ručke dodjelom vrijednosti nullptr dobro je definirano. Objekti na koje se upućuje referencama moraju ostati živi dovoljno dugo.
Ovaj se zapis odnosi na C++23; zastavica prevoditelja u repozitoriju ne potvrđuje podršku u produkcijskom izvršnom okruženju. Dostavljeni dokument radni je nacrt koji se razvija, a ne konačno izdanje C++23. Primjer je potrebno lokalno provjeriti i namjerno poziva std::terminate() u slučaju neobrađene iznimke.
Primjeri
#include <coroutine>
#include <exception>
#include <iostream>
class Task {
public:
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() noexcept { std::terminate(); }
};
using Handle = std::coroutine_handle<promise_type>;
explicit Task(Handle handle) noexcept : handle_(handle) {}
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
~Task() { handle_.destroy(); }
void resume() {
if (!handle_.done()) {
handle_.resume();
}
}
private:
Handle handle_;
};
Task steps() {
std::cout << "1\n";
co_await std::suspend_always{};
std::cout << "2\n";
co_return;
}
int main() {
auto task = steps();
task.resume();
task.resume();
task.resume();
}
Rezultat
1 2
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.