Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti