Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje