Namespaces
Variants

std:: noop_coroutine

From cppreference.net
C++
Utilities library
Coroutine support
Coroutine traits
(C++20)
Coroutine handle
(C++20)
No-op coroutines
(C++20)
noop_coroutine
(C++20)
Trivial awaitables
(C++20)
(C++20)
Range generators
(C++23)
Definido en el encabezado <coroutine>
std:: noop_coroutine_handle noop_coroutine ( ) noexcept ;
(desde C++20)

Devuelve un manejador de corrutina que hace referencia a una corrutina sin operación.

Si ya existe un estado de corrutina de corrutina sin operación, no está especificado si una llamada posterior a noop_coroutine devuelve un identificador de corrutina previamente obtenido, o un identificador de corrutina que hace referencia a un nuevo estado de corrutina de corrutina sin operación.

Contenidos

Parámetros

(ninguno)

Valor de retorno

Un std::noop_coroutine_handle que hace referencia a una corrutina no operativa.

Notas

Los valores devueltos de diferentes llamadas a noop_coroutine pueden y pueden no ser iguales al compararlos.

noop_coroutine solo puede devolver un noop_coroutine_handle que haga referencia a un objeto de estado de corrutina sin iniciar una corrutina.

Ejemplo

Ejecutar este código 
#include <coroutine>
#include <iostream>
#include <utility>
template<class T>
struct task
{
    struct promise_type
    {
        auto get_return_object()
        {
            return task(std::coroutine_handle<promise_type>::from_promise(*this));
        }
        std::suspend_always initial_suspend() { return {}; }
        struct final_awaiter
        {
            bool await_ready() noexcept { return false; }
            void await_resume() noexcept {}
            std::coroutine_handle<>
                await_suspend(std::coroutine_handle<promise_type> h) noexcept
            {
                // final_awaiter::await_suspend se llama cuando la ejecución del
                // la corrutina actual (referida por 'h') está a punto de finalizar.
                // Si la corrutina actual fue reanudada por otra corrutina mediante
                // co_await get_task(), se ha almacenado un handle a esa corrutina
                // como h.promise().previous. En ese caso, devuelve el handle para reanudar
                // la corrutina anterior.
                // De lo contrario, retorna noop_coroutine(), cuya reanudación no hace nada.
                if (auto previous = h.promise().previous; previous)
                    return previous;
                else
                    return std::noop_coroutine();
            }
        };
        final_awaiter final_suspend() noexcept { return {}; }
        void unhandled_exception() { throw; }
        void return_value(T value) { result = std::move(value); }
        T result;
        std::coroutine_handle<> previous;
    };
    task(std::coroutine_handle<promise_type> h) : coro(h) {}
    task(task&& t) = delete;
    ~task() { coro.destroy(); }
    struct awaiter
    {
        bool await_ready() { return false; }
        T await_resume() { return std::move(coro.promise().result); }
        auto await_suspend(std::coroutine_handle<> h)
        {
            coro.promise().previous = h;
            return coro;
        }
        std::coroutine_handle<promise_type> coro;
    };
    awaiter operator co_await() { return awaiter{coro}; }
    T operator()()
    {
        coro.resume();
        return std::move(coro.promise().result);
    }
private:
    std::coroutine_handle<promise_type> coro;
};
task<int> get_random()
{
    std::cout << "en get_random()\n";
    co_return 4;
}
task<int> test()
{
    task<int> v = get_random();
    task<int> u = get_random();
    std::cout << "en test()\n";
    int x = (co_await v + co_await u);
    co_return x;
}
int main()
{
    task<int> t = test();
    int result = t();
    std::cout << result << '\n';
}

Salida: 

en test()
en get_random()
en get_random()
8

Véase también

(C++20)
utilizado para corrutinas sin efectos observables
(clase)
(C++20)
std:: coroutine_handle < std:: noop_coroutine_promise > , destinado a hacer referencia a una corrutina no operativa
(typedef)