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.