CKTIS / C++
co_return — zaključek korutine
`co_return` konča izvajanje telesa korutine in njen rezultat posreduje objektu `promise`, namesto da bi ga vrnil neposredno kot običajni `return`. Izvajanje se nato nadaljuje pri `final_suspend()`; življenjska doba stanja korutine je odvisna od tega, kako se upravlja lastništvo nad njim.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_return;
co_return expression;
co_return braced-init-list;co_return označuje zaključek korutine. Že prisotnost tega stavka pomeni, da je funkcija korutina, tudi če ne vsebuje co_await ali co_yield. Objekt, ki ga vrne klic funkcije, zagotovi promise.get_return_object(); operand stavka co_return ni nujno istega tipa kot povratni tip funkcije.
Če je operand izraz tipa, ki ni void, ali inicializacijski seznam v zavitih oklepajih, se pokliče promise.return_value(...). Stavek co_return; pokliče promise.return_void(). Če je operand tipa void, se najprej ovrednoti izraz, nato pa se pokliče return_void(). Rezultat teh klicev mora biti tipa void.
Izvajanje se nato nadaljuje pri final_suspend(). Konec izvajanja telesa še ne pomeni, da se stanje korutine samodejno uniči. V prikazanem primeru initial_suspend() omogoči takojšnje izvajanje telesa, return_value(int) shrani 42, final_suspend() pa ohrani stanje, da ga je mogoče prebrati. Destruktor tipa Result sprosti stanje s klicem destroy(); kopiranje lastnika ni dovoljeno.
Telo korutine ne sme vsebovati običajnega stavka return. V C++23 je iztek izvajanja na koncu telesa enakovreden izvedbi stavka co_return;, če ima tip objekta promise član z imenom return_void. Če ta član obstaja, vendar implicitni klic promise.return_void() ni veljaven, program ni pravilno oblikovan. Če tip objekta promise nima člana s tem imenom, je vedenje ob izteku izvajanja na koncu telesa nedefinirano. Ta zapis obravnava C++23; na navedenem spletišču je objavljen delovni osnutek, ki se še spreminja, ne pa dokončno besedilo standarda C++23.
Primeri
#include <coroutine>
#include <exception>
#include <iostream>
struct Result {
struct promise_type;
using Handle = std::coroutine_handle<promise_type>;
struct promise_type {
int value = 0;
Result get_return_object() {
return Result{Handle::from_promise(*this)};
}
std::suspend_never initial_suspend() noexcept { return {}; }
std::suspend_always final_suspend() noexcept { return {}; }
void return_value(int n) noexcept { value = n; }
void unhandled_exception() noexcept { std::terminate(); }
};
Handle handle;
explicit Result(Handle h) noexcept : handle(h) {}
Result(const Result&) = delete;
Result& operator=(const Result&) = delete;
~Result() { handle.destroy(); }
int value() const { return handle.promise().value; }
};
Result answer() {
co_return 42;
}
int main() {
auto result = answer();
std::cout << result.value() << '\n';
}
Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju po metodi, opisani v dokazilu o preverjanju prav te različice.