CKTIS / C++
co_return — завършване на корутина
co_return завършва изпълнението на тялото на корутина и предава резултата на обекта promise, вместо да го връща директно като обикновен return. След това корутината продължава с final_suspend(); продължителността на живота на състоянието ѝ зависи от механизма за управление на корутината.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
co_return;
co_return expression;
co_return braced-init-list;co_return обозначава завършването на корутина. Самото му наличие превръща функцията в корутина, дори без co_await или co_yield. Обектът, който се връща при извикване на функцията, идва от promise.get_return_object(); операндът на co_return не е задължително да е от типа на връщане на функцията.
За израз с тип, различен от void, или списък с инициализатори във фигурни скоби се извиква promise.return_value(...). co_return; извиква promise.return_void(). При операнд от тип void изразът първо се оценява, а след това се извиква return_void(). Тези извиквания трябва да дават резултат от тип void.
След това управлението продължава към final_suspend(). Завършването на тялото не означава автоматично унищожаване на състоянието на корутината. В примера initial_suspend() позволява тялото да се изпълни веднага, return_value(int) записва 42, а final_suspend() запазва състоянието за проверка. Деструкторът на Result го освобождава чрез destroy(); копирането на притежателя е забранено.
Тялото на корутина не трябва да съдържа обикновен return. В C++23 достигането до края на тялото е равносилно на изпълнение на co_return;, ако типът на обекта promise има член с име return_void. Ако такъв член съществува, но подразбиращото се извикване promise.return_void() е невалидно, програмата е некоректно формирана. Ако типът на обекта promise няма член с това име, достигането до края на тялото води до неопределено поведение. Този запис се отнася за C++23; посоченият сайт съдържа развиващ се работен проект, а не фиксиран текст на C++23.
Примери
#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';
}
Резултат
42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.