База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници