Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::noop_coroutine — un manejador de una corrutina sin efecto

std::noop_coroutine() devuelve un manejador no nulo de una corrutina especial cuya reanudación y destrucción no tienen efectos observables. No es un manejador vacío.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <coroutine>
std::noop_coroutine_handle std::noop_coroutine() noexcept;

std::noop_coroutine(), de <coroutine>, es una función noexcept. Devuelve std::noop_coroutine_handle, un alias de std::coroutine_handle<std::noop_coroutine_promise>. No requiere argumentos ni una función de corrutina escrita por el usuario.

El manejador devuelto no está vacío: la conversión a bool da true, address() no es nulo y done() da false. Las llamadas a resume(), operator() y destroy() no tienen efecto; en particular, destroy() no invalida este manejador. Estas garantías no se aplican a manejadores de corrutina arbitrarios.

El manejador se puede convertir a std::coroutine_handle<>. Incluso después de esta conversión, reanudarlo y destruirlo no tiene efectos observables. No des por sentado que los manejadores obtenidos de dos llamadas distintas a std::noop_coroutine() son iguales: el estándar permite cualquiera de los dos resultados de la comparación.

El ejemplo comprueba el estado antes y después de las operaciones, también después de la conversión a std::coroutine_handle<>. No imprime direcciones ni compara llamadas distintas, por lo que la salida esperada es determinista.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes