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

CKTIS / C++

Корутини

Корутина може да спре изпълнението и по-късно да го продължи, като запази необходимото състояние. Ключовите думи co_await, co_yield и co_return работят заедно с тип promise и дръжка на корутина; не стартират автоматично нишка или планировчик.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

co_await expression; co_yield expression; co_return [expression];

Корутина е функция, чието тяло съдържа co_await, co_yield или co_return. При спиране тя запазва състоянието, необходимо за продължаване. Управлението може да се върне към кода, който я е извикал или възобновил. Ако обаче await_suspend() на awaiter-а върне дръжка към друга корутина, управлението преминава директно към тази корутина. Това не означава автоматично паралелно изпълнение: корутината сама по себе си не създава нишка или планировчик.

co_await използва протокола awaiter: await_ready() проверява дали резултатът е готов, await_suspend() обработва спирането, а await_resume() предоставя резултата. Не всяко co_await оставя корутината действително спряна. co_yield value изчаква резултата от promise.yield_value(value), без да прилага await_transform на обекта promise. За разлика от него изрично написаният израз co_await promise.yield_value(value) използва await_transform, ако типът promise го предоставя. Затова замяната може да промени поведението или да доведе до грешка при компилация. co_return завършва тялото на корутината, вместо да предаде стойност директно на извикващия.

Типът promise, обикновено достъпен като promise_type на типа на връщане, определя, наред с другото, обекта резултат, началното и крайното спиране, завършването и обработката на изключения. <coroutine> предоставя std::coroutine_handle и std::suspend_always. Дръжката сама не управлява жизнения цикъл на състоянието: отговорността за унищожаването му трябва да бъде изрично определена.

В примера Task е собственик, който не може да се копира или премества. initial_suspend() отлага изпълнението на тялото, а final_suspend() запазва състоянието, за да бъде унищожено от деструктора. Използваният в примера std::suspend_always не предава управлението директно на друга корутина. Две възобновявания отпечатват 1 и 2; третото не прави нищо благодарение на done(). Възобновяването на завършена или неспряна корутина води до неопределено поведение. След унищожаването на състоянието на корутината опитът тя да бъде възобновена чрез дръжка към това състояние също води до неопределено поведение. Нулирането на тази дръжка чрез присвояване на nullptr обаче е добре дефинирано. Обектите, към които се сочи чрез препратки, трябва да останат живи достатъчно дълго.

Този запис е за C++23; флагът на компилатора в хранилището не удостоверява поддръжка в производствена среда за изпълнение. Предоставеният документ е развиващ се работен проект, а не окончателно издание на C++23. Примерът трябва да бъде проверен локално и умишлено извиква std::terminate() при необработено изключение.

Примери

#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();
}

Резултат

1
2

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

Източници