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

CKTIS / C++

std::suspend_never — изчакване без спиране на корутина

std::suspend_never от <coroutine> е прост awaiter, който не спира корутина и не връща стойност. С него може да се зададе незабавно стартиране или завършване на корутина; при завършването трябва внимателно да се следи времето на живот на състоянието ѝ.

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

Синтаксис

#include <coroutine>
co_await std::suspend_never{};

std::suspend_never е тип от <coroutine>, чиито обекти могат директно да служат като awaiter-и за co_await. Той не спира корутината и не връща стойност: типът на резултата е void. За разлика от него, std::suspend_always, използван директно като awaiter, винаги спира корутината.

await_ready() връща true, затова протоколът за изчакване пропуска await_suspend(std::coroutine_handle<>) и извиква await_resume(). Последните две функции не правят нищо и връщат void; и трите са constexpr, const и noexcept. Това предотвратява спирането в тази конкретна точка, но не и през цялата корутина. Персонализиран await_transform на обекта promise може да промени тълкуването на операнда на co_await.

Неявните изрази co_await за initial_suspend() и final_suspend() пропускат await_transform, но все пак могат да изберат претоварен operator co_await, който предоставя awaiter, спиращ корутината. Следователно само типът на връщаната стойност не гарантира, че няма да има спиране. Ако самият обект std::suspend_never, върнат от initial_suspend(), се използва като awaiter, изпълнението веднага преминава към тялото на корутината. Ако самият обект, върнат от final_suspend(), се използва като awaiter, няма крайно спиране и състоянието на корутината се унищожава при завършване. Всеки запазен handle към това състояние става висящ — след това не бива чрез него да се извикват resume(), done() или destroy().

В примера immediate_task не съхранява handle. run() извършва и двете извеждания, преди да се върне към main(), а състоянието ѝ се почиства автоматично. Записът е за C++23; посоченият сайт съдържа развиващ се проект на стандарт, а не замразена публикация на C++23. Изпълнение в производствена среда не е удостоверено.

Примери

#include <coroutine>
#include <exception>
#include <iostream>

struct immediate_task {
    struct promise_type {
        immediate_task get_return_object() noexcept { return {}; }
        std::suspend_never initial_suspend() noexcept { return {}; }
        std::suspend_never final_suspend() noexcept { return {}; }
        void return_void() noexcept {}
        void unhandled_exception() noexcept { std::terminate(); }
    };
};

immediate_task run() {
    std::cout << "before\n";
    co_await std::suspend_never{};
    std::cout << "after\n";
    co_return;
}

int main() {
    run();
    std::cout << "returned\n";
}

Резултат

before
after
returned

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

Източници