Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::suspend_never — čekanje bez obustavljanja korutine

std::suspend_never iz <coroutine> jednostavan je awaiter koji ne obustavlja korutinu i ne daje vrijednost. Omogućuje određivanje trenutačnog pokretanja ili dovršetka korutine; pri dovršetku treba pažljivo paziti na životni vijek njezina stanja.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <coroutine>
co_await std::suspend_never{};

std::suspend_never tip je iz <coroutine> čiji objekti mogu izravno služiti kao awaiteri za co_await. Ne obustavlja korutinu i ne daje vrijednost: tip rezultata je void. Nasuprot tome, std::suspend_always pri izravnoj uporabi kao awaiter uvijek obustavlja korutinu.

await_ready() vraća true, pa await protokol preskače await_suspend(std::coroutine_handle<>) i poziva await_resume(). Posljednje dvije funkcije ne rade ništa i vraćaju void; sve tri su constexpr, const i noexcept. Time se sprječava obustava na toj konkretnoj točki, a ne tijekom cijele korutine. Prilagođeni await_transform objekta promise može promijeniti tumačenje operanda co_await.

Implicitni izrazi co_await za initial_suspend() i final_suspend() preskaču await_transform, ali ipak mogu odabrati preopterećeni operator co_await koji daje awaiter koji obustavlja korutinu. Sam povratni tip stoga ne jamči da neće doći do obustave. Ako objekt std::suspend_never koji vrati initial_suspend() sam služi kao awaiter, izvršavanje odmah prelazi u tijelo korutine. Ako objekt koji vrati final_suspend() sam služi kao awaiter, nema završne obustave i stanje korutine uništava se po dovršetku. Svaki zadržani handle na to stanje postaje nevaljan — nakon toga preko njega ne smijete pozivati resume(), done() ni destroy().

U primjeru immediate_task ne pohranjuje handle. run() izvršava oba ispisa prije povratka u main(), a njezino se stanje automatski čisti. Ovaj se zapis odnosi na C++23; navedeno web-mjesto sadrži nacrt standarda koji se razvija, a ne nepromjenjivu objavu C++23. Izvršavanje u produkcijskom okruženju nije potvrđeno.

Primjeri

#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";
}

Rezultat

before
after
returned

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori