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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.