CKTIS / C++
std::noop_coroutine — um handle para uma coroutine sem efeitos
std::noop_coroutine() devolve um handle não nulo para uma coroutine especial cuja retoma e destruição não têm efeitos observáveis. Não é um handle vazio.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;std::noop_coroutine(), de <coroutine>, é uma função noexcept. Devolve std::noop_coroutine_handle, um alias de std::coroutine_handle<std::noop_coroutine_promise>. Não requer argumentos nem uma função coroutine escrita pelo utilizador.
O handle devolvido não está vazio: a conversão para bool dá true, address() é diferente de null e done() dá false. As chamadas a resume(), operator() e destroy() não têm efeitos; em particular, destroy() não invalida este handle. Estas garantias não se aplicam a handles de coroutine arbitrários.
O handle pode ser convertido para std::coroutine_handle<>. Mesmo após esta conversão, retomá-lo e destruí-lo não tem efeitos observáveis. Não assuma que os handles obtidos em duas chamadas distintas a std::noop_coroutine() são iguais: a norma permite ambos os resultados da comparação.
O exemplo verifica o estado antes e depois das operações, incluindo após a conversão para std::coroutine_handle<>. Não apresenta endereços nem compara chamadas distintas, mantendo determinístico o resultado esperado.
Exemplos
#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';
}
Resultado
valid=true done=false after: valid=true done=false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.