CKTIS / C++
co_return — dovršetak korutine
co_return završava izvođenje tijela korutine i predaje rezultat objektu promise, umjesto da ga izravno vraća kao obični return. Korutina zatim nastavlja s final_suspend(); trajanje njezina stanja ovisi o mehanizmu upravljanja korutinom.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
co_return;
co_return expression;
co_return braced-init-list;co_return označava dovršetak korutine. Već sama njegova prisutnost čini funkciju korutinom, čak i bez co_await ili co_yield. Objekt koji vraća poziv funkcije dolazi iz promise.get_return_object(); operand co_return ne mora biti povratnog tipa funkcije.
Za izraz tipa različitog od void ili popis inicijalizatora u vitičastim zagradama poziva se promise.return_value(...). co_return; poziva promise.return_void(). Ako je operand tipa void, najprije se izračunava izraz, a zatim se poziva return_void(). Ti pozivi moraju dati rezultat tipa void.
Kontrola zatim prelazi na final_suspend(). Dovršetak tijela ne znači automatsko uništavanje stanja korutine. U primjeru initial_suspend() omogućuje da se tijelo odmah izvrši, return_value(int) pohranjuje 42, a final_suspend() čuva stanje za pregled. Destruktor Result oslobađa ga pomoću destroy(); kopiranje vlasnika nije dopušteno.
Tijelo korutine ne smije sadržavati obični return. U C++23 dolazak do kraja tijela jednak je izvršavanju naredbe co_return; ako tip objekta promise ima član naziva return_void. Ako taj član postoji, ali implicitni poziv promise.return_void() nije valjan, program nije ispravno oblikovan. Ako tip objekta promise nema član s tim nazivom, dolazak do kraja tijela uzrokuje nedefinirano ponašanje. Ovaj se unos odnosi na C++23; navedeno web-mjesto sadrži radni nacrt koji se razvija, a ne zamrznuti tekst C++23.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.