Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::suspend_never — oczekiwanie bez zawieszania korutyny

std::suspend_never z nagłówka <coroutine> jest prostym obiektem oczekiwania, który nie zawiesza korutyny i nie dostarcza wartości. Ułatwia określenie natychmiastowego rozpoczęcia lub zakończenia korutyny; przy zakończeniu wymaga uwagi na czas życia jej stanu.

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

Składnia

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

std::suspend_never to typ z nagłówka <coroutine>, którego obiekt może bezpośrednio pełnić rolę obiektu oczekiwania dla co_await. Nie zawiesza korutyny i nie dostarcza wartości: typem wyniku jest void. Dla porównania std::suspend_always przy bezpośrednim użyciu jako obiekt oczekiwania zawsze zawiesza korutynę.

await_ready() zwraca true, dlatego protokół oczekiwania pomija await_suspend(std::coroutine_handle<>) i wywołuje await_resume(). Obie ostatnie funkcje nic nie robią i zwracają void; wszystkie trzy są constexpr, const i noexcept. To brak zawieszenia w tym konkretnym punkcie, a nie obietnica, że cała korutyna nigdy się nie zawiesi. Własne await_transform obiektu promise może zmienić interpretację operandu co_await.

Niejawne wyrażenia co_await dla initial_suspend() i final_suspend() pomijają await_transform, ale nadal mogą użyć przeciążonego operator co_await, który zwraca obiekt oczekiwania zawieszający korutynę. Sam typ zwracany przez te funkcje nie przesądza więc o braku zawieszenia. Jeśli obiekt std::suspend_never zwrócony przez initial_suspend() sam pełni rolę obiektu oczekiwania, wykonanie od razu przechodzi do ciała korutyny. Jeśli obiekt zwrócony przez final_suspend() sam pełni tę rolę, nie ma końcowego zawieszenia i stan korutyny zostaje zniszczony po zakończeniu. Zachowany uchwyt do tego stanu staje się wiszący — nie wolno następnie wywoływać przez niego resume(), done() ani destroy().

W przykładzie immediate_task nie przechowuje uchwytu. run() wykonuje oba wypisania przed powrotem do main(), a jego stan jest automatycznie sprzątany. Kontekst wpisu to C++23; wskazany serwis zawiera rozwijany szkic standardu, a nie zamrożoną publikację C++23. Nie potwierdzono wykonania w środowisku produkcyjnym.

Przykłady

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

Wynik

before
after
returned

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła