Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes