CKTIS / C++
std::suspend_never — čakanie bez pozastavenia korutiny
std::suspend_never z <coroutine> je jednoduchý awaiter, ktorý korutinu nepozastaví a neposkytne žiadnu hodnotu. Umožňuje určiť okamžité spustenie alebo dokončenie korutiny; pri dokončení treba dôsledne dbať na životnosť jej stavu.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <coroutine>
co_await std::suspend_never{};std::suspend_never je typ z <coroutine>, ktorého objekty môžu priamo slúžiť ako awaitery pre co_await. Korutinu nepozastaví a neposkytne žiadnu hodnotu: typ výsledku je void. Naopak, std::suspend_always pri priamom použití ako awaiter korutinu vždy pozastaví.
await_ready() vráti true, takže await protokol preskočí await_suspend(std::coroutine_handle<>) a zavolá await_resume(). Posledné dve funkcie nič nerobia a vracajú void; všetky tri sú constexpr, const a noexcept. Tým sa zabráni pozastaveniu v tomto konkrétnom bode, nie počas celej korutiny. Vlastný await_transform objektu promise môže zmeniť interpretáciu operandu co_await.
Implicitné výrazy co_await pre initial_suspend() a final_suspend() preskakujú await_transform, ale stále môžu vybrať preťažený operator co_await, ktorý poskytne awaiter, čo korutinu pozastaví. Samotný návratový typ teda nezaručuje, že k pozastaveniu nedôjde. Ak samotný objekt std::suspend_never vrátený z initial_suspend() slúži ako awaiter, vykonávanie ihneď pokračuje v tele korutiny. Ak ako awaiter slúži samotný objekt vrátený z final_suspend(), záverečné pozastavenie nenastane a stav korutiny sa pri dokončení zničí. Každý uchovaný handle na tento stav sa stane neplatným — následne sa cez neho nesmie volať resume(), done() ani destroy().
V príklade immediate_task neukladá žiadny handle. run() vykoná oba výpisy pred návratom do main() a jeho stav sa automaticky vyčistí. Záznam sa vzťahuje na C++23; uvedená stránka obsahuje priebežne sa vyvíjajúci návrh štandardu, nie nemenné vydanie C++23. Vykonanie v produkčnom prostredí nebolo potvrdené.
Príklady
#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";
}
Výsledok
before after returned
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.