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.