CKTIS / C++
std::noop_coroutine — un handle per una coroutine senza effetti
std::noop_coroutine() restituisce un handle non nullo a una coroutine speciale la cui ripresa e distruzione non hanno effetti osservabili. Non è un handle vuoto.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine() di <coroutine> è una funzione noexcept. Restituisce std::noop_coroutine_handle, un alias di std::coroutine_handle<std::noop_coroutine_promise>. Non richiede né argomenti né una funzione coroutine scritta dall’utente.
L’handle restituito non è vuoto: la conversione a bool dà true, address() è diverso da null e done() dà false. Le chiamate a resume(), operator() e destroy() non hanno effetti; in particolare, destroy() non invalida questo handle. Queste garanzie non valgono per handle di coroutine arbitrari.
L’handle può essere convertito in std::coroutine_handle<>. Anche dopo questa conversione, la ripresa e la distruzione non hanno effetti osservabili. Non dare per scontato che gli handle ottenuti da due chiamate separate a std::noop_coroutine() siano uguali: lo standard consente entrambi i risultati del confronto.
L’esempio controlla lo stato prima e dopo le operazioni, anche dopo la conversione in std::coroutine_handle<>. Non stampa indirizzi e non confronta chiamate separate, così l’output atteso rimane deterministico.
Esempi
#include <coroutine>
#include <iostream>
int main() {
auto h = std::noop_coroutine();
std::cout << std::boolalpha;
std::cout << "valid=" << static_cast<bool>(h)
<< " done=" << h.done() << '\n';
h.resume();
h();
h.destroy();
std::coroutine_handle<> erased = h;
erased.resume();
erased.destroy();
std::cout << "after: valid=" << static_cast<bool>(h)
<< " done=" << h.done() << '\n';
}
Risultato
valid=true done=false after: valid=true done=false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.