CKTIS / C++
std::suspend_always — bezpodmínečné pozastavení korutiny
std::suspend_always z <coroutine> je jednoduchý awaitable, který pozastaví korutinu, aniž vytvoří hodnotu. Neplánuje její obnovení: spravující kód musí uchovat handle a pozastavenou korutinu obnovit nebo zničit.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <coroutine>
co_await std::suspend_always{};std::suspend_always z <coroutine> implementuje protokol awaiter. await_ready() vrací false, await_suspend(std::coroutine_handle<>) nic nedělá a vrací void a await_resume() také nic nedělá a vrací void. Všechny tři metody jsou constexpr, const a noexcept. Naproti tomu std::suspend_never vrací z await_ready() hodnotu true.
Když je tento objekt skutečně awaiterem, co_await std::suspend_always{}; pozastaví korutinu a předá řízení jejímu volajícímu nebo tomu, kdo ji obnovuje. Po obnovení vykonávání pokračuje, aniž získá hodnotu. Typ neblokuje vlákno, nespouští časovač ani neplánuje obnovení. await_transform objektu promise nebo přetížený operator co_await mohou vybraný awaiter změnit.
V příkladu initial_suspend() odloží vykonávání těla až do prvního resume(). První obnovení vypíše A a dosáhne výslovného pozastavení; druhé vypíše B a dosáhne final_suspend(). Destruktor vlastníka zničí uchovávaný frame. Kopírování vlastníka je zakázáno, aby se předešlo dvojímu zničení.
Neobnovujte korutinu v jejím konečném bodě pozastavení a nepoužívejte handle po zničení jejího framu. resume() v příkladu před obnovením kontroluje done(). Tento záznam cílí na kompilaci s -std=c++23; dodaný dokument je průběžně vyvíjený návrh, nikoli definitivní vydání C++23. Podporu kompilátoru a produkčního běhového prostředí je třeba ověřit lokálně.
Příklady
#include <coroutine>
#include <exception>
#include <iostream>
struct Task {
struct promise_type {
Task get_return_object() {
return Task{std::coroutine_handle<promise_type>::from_promise(*this)};
}
std::suspend_always initial_suspend() noexcept { return {}; }
std::suspend_always final_suspend() noexcept { return {}; }
void return_void() noexcept {}
void unhandled_exception() { std::terminate(); }
};
std::coroutine_handle<promise_type> handle;
explicit Task(std::coroutine_handle<promise_type> h) : handle(h) {}
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
~Task() { handle.destroy(); }
void resume() {
if (!handle.done()) handle.resume();
}
};
Task work() {
std::cout << "A\n";
co_await std::suspend_always{};
std::cout << "B\n";
}
int main() {
auto task = work();
std::cout << "created\n";
task.resume();
std::cout << "paused\n";
task.resume();
std::cout << "finished\n";
}
Výsledek
created A paused B finished
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.