Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje