Пространства имён
Варианты
Действия

std::noop_coroutine

Материал из cppreference.com
< cpp‎ | coroutine
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
Трёхстороннее сравнение (C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
Операции обмена и типа
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
Поддержка сопрограмм
Свойства сопрограмм
Дескриптор сопрограммы
Сопрограммы без операций
noop_coroutine
(C++20)
Тривиальные ожидания
Генераторы диапазонов
(C++23)
 
Определено в заголовочном файле <coroutine>
std::noop_coroutine_handle noop_coroutine() noexcept;
(начиная с C++20)

Возвращ��ет дескриптор сопрограммы, ссылающийся на неактивную сопрограмму.

Если уже было состояние сопрограммы без операции, не указано, возвращает ли последующий вызов noop_coroutine ранее полученный дескриптор сопрограммы или дескриптор сопрограммы, ссылающийся на новое состояние сопрограммы без операции.

Содержание

[править] Параметры

(нет)

[править] Возвращаемое значение

std::noop_coroutine_handle ссылается на неактивную сопрограмму.

[править] Примечание

Возвращаемые значения из разных вызовов noop_coroutine могут при сравнении быть равными и не равными.

noop_coroutine может возвращать только noop_coroutine_handle, ссылающийся на объект состояния сопрограммы, без запуска сопрограммы.

[править] Пример

#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 вызывается, когда выполнение текущей
                // сопрограммы (обозначенной буквой 'h') подходит к концу.
                // Если текущая сопрограмма была возобновлена другой сопрограммой
                // через co_await get_task(), дескриптор этой сопрограммы сохраняется
                // как h.promise().previous. В этом случае возвращается дескриптор, чтобы
                // возобновить предыдущую сопрограмму.
                // Иначе везвращается noop_coroutine(), возобновление которого ничего
                // не делает.
 
                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 << "в get_random()\n";
    co_return 4;
}
task<int> test()
{
    task<int> v = get_random();
    task<int> u = get_random();
    std::cout << "в 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';
}

Вывод:

в test()
в get_random()
в get_random()
8

[править] Смотрите также

используется для сопрограмм без видимых эффектов
(класс) [править]
std::coroutine_handle<std::noop_coroutine_promise>, предназначенный для ссылки на сопрограмму без операций
(определение типа) [править]