CKTIS / C++
std::suspend_never — čekání bez pozastavení korutiny
std::suspend_never z <coroutine> je jednoduchý awaiter, který korutinu nepozastaví a neposkytne žádnou hodnotu. Umožňuje určit okamžité spuštění nebo dokončení korutiny; při dokončení je třeba pečlivě hlídat životnost jejího stavu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <coroutine>
co_await std::suspend_never{};std::suspend_never je typ z <coroutine>, jehož objekty mohou přímo sloužit jako awaitery pro co_await. Korutinu nepozastaví a neposkytne žádnou hodnotu: typ výsledku je void. Naproti tomu std::suspend_always při přímém použití jako awaiter korutinu vždy pozastaví.
await_ready() vrátí true, takže await protokol přeskočí await_suspend(std::coroutine_handle<>) a zavolá await_resume(). Poslední dvě funkce nic nedělají a vracejí void; všechny tři jsou constexpr, const a noexcept. Tím se zabrání pozastavení v tomto konkrétním bodě, nikoli v celé korutině. Vlastní await_transform objektu promise může změnit interpretaci operandu co_await.
Implicitní výrazy co_await pro initial_suspend() a final_suspend() přeskakují await_transform, ale stále mohou vybrat přetížený operator co_await, který poskytne awaiter, jenž korutinu pozastaví. Samotný návratový typ tedy nezaručuje, že k pozastavení nedojde. Pokud samotný objekt std::suspend_never vrácený z initial_suspend() slouží jako awaiter, provádění ihned pokračuje v těle korutiny. Pokud jako awaiter slouží samotný objekt vrácený z final_suspend(), k závěrečnému pozastavení nedojde a stav korutiny se při dokončení zničí. Každý uchovaný handle na tento stav se stane neplatným — následně se přes něj nesmí volat resume(), done() ani destroy().
V příkladu immediate_task žádný handle neukládá. run() provede oba výpisy před návratem do main() a jeho stav se automaticky uklidí. Záznam se vztahuje k C++23; uvedený web obsahuje průběžně aktualizovaný návrh normy, nikoli neměnné vydání C++23. Provedení v produkčním prostředí nebylo doloženo.
Pří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ýsledek
before after returned
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.