Класс completion_future

Представляет будущее, соответствующее асинхронной операции C++ AMP.

Синтаксис

class completion_future;

Members

Открытые конструкторы

Имя	Описание
Конструктор "completion_future"	Инициализирует новый экземпляр класса completion_future.
Деструктор ~completion_future	Уничтожает completion_future объект.

Открытые методы

Имя	Описание
get	Ожидает завершения связанной асинхронной операции.
тогда	Связывает объект функции обратного вызова с completion_future объектом, который будет выполняться при завершении связанной асинхронной операции.
to_task	Возвращает объект, соответствующий указанной task асинхронной операции.
действительный	Получает логическое значение, которое указывает, связан ли объект с асинхронной операцией.
ждать	Блокируется до тех пор, пока не завершится связанная асинхронная операция.
wait_for	Блокируется, пока связанная асинхронная операция не завершится или пока не истечёт время, указанное в _Rel_time.
wait_until	Блокируется до завершения связанной асинхронной операции или до тех пор, пока текущее время не превысит указанное значение _Abs_time.

Открытые операторы

Имя	Описание
оператор std::shared_future<void>	Неявно преобразует объект completion_future в объект std::shared_future.
operator=	Копирует содержимое указанного объекта completion_future в данный объект.

Иерархия наследования

completion_future

Требования

Заголовок: amprt.h

Пространство имен: конкурентность

завершение_будущего

Инициализирует новый экземпляр класса completion_future.

Синтаксис

completion_future();

completion_future(
    const completion_future& _Other );

completion_future(
    completion_future&& _Other );

Параметры

_Other
completion_future Объект для копирования или перемещения.

Список перегрузок

Имя	Описание
completion_future();	Инициализирует новый экземпляр completion_future класса
completion_future(const completion_future& _Other);	Инициализирует новый экземпляр completion_future класса путем копирования конструктора.
completion_future(completion_future&& _Other);	Инициализирует новый экземпляр completion_future класса путем перемещения конструктора.

get

Ожидает завершения связанной асинхронной операции. Выбрасывает сохранённое исключение, если оно было обнаружено во время асинхронной операции.

Синтаксис

void get() const;

оператор std::shared_future<void>

Неявно преобразует объект completion_future в объект std::shared_future.

Синтаксис

operator std::shared_future<void>() const;

Возвращаемое значение

Объект std::shared_future.

operator=

Копирует содержимое указанного объекта completion_future в данный объект.

Синтаксис

completion_future&  operator= (const completion_future& _Other );
completion_future&  operator= (completion_future&& _Other );

Параметры

_Other
Объект, из которого выполняется копирование.

Возвращаемое значение

Ссылка на этот completion_future объект.

Список перегрузок

Имя	Описание
completion_future& operator=(const completion_future& _Other);	Копирует содержимое указанного completion_future объекта в этот объект с помощью глубокой копии.
completion_future& operator=(completion_future&& _Other);	Копирует содержимое указанного completion_future объекта в этот объект с помощью назначения перемещения.

затем

Связывает объект функции обратного вызова с completion_future объектом, который будет выполняться при завершении связанной асинхронной операции.

Синтаксис

template <typename _Functor>
void then(const _Functor & _Func ) const;

Параметры

_Функтор
Обратный вызов функтор.

_Func
Объект функции обратного вызова.

to_task

Возвращает объект, соответствующий указанной task асинхронной операции.

Синтаксис

concurrency::task<void> to_task() const;

Возвращаемое значение

task Объект, соответствующий связанной асинхронной операции.

действительный

Получает логическое значение, которое указывает, связан ли объект с асинхронной операцией.

Синтаксис

bool valid() const;

Возвращаемое значение

true, если объект связан с асинхронной операцией; в противном случае false.

wait

Блокируется до тех пор, пока не завершится связанная асинхронная операция.

Синтаксис

void wait() const;

ожидать

Блокируется до завершения связанной асинхронной операции или истечения времени, указанного _Rel_time.

Синтаксис

template <
    class _Rep,
    class _Period
>
std::future_status::future_status wait_for(
    const std::chrono::duration< _Rep, _Period>& _Rel_time ) const;

Параметры

_Rep
Арифметический тип, представляющий количество галок.

_Период
Std::ratio, представляющий количество секунд в одном тике.

_Rel_time
Максимальное время ожидания завершения операции.

Возвращаемое значение

Возвращает:

• std::future_status::deferred Если связанная асинхронная операция не выполняется.

• std::future_status::ready Если связанная асинхронная операция завершена.

• std::future_status::timeout если указанный период времени истек.

wait_until

Блокируется до завершения связанной асинхронной операции или до тех пор, пока текущее время не превысит указанное значение _Abs_time.

Синтаксис

template <
    class _Clock,
    class _Duration
>
std::future_status::future_status wait_until(
    const std::chrono::time_point< _Clock, _Duration>& _Abs_time ) const;

Параметры

_Часы
Часы, на которых измеряется эта точка времени.

_Длительность
Интервал времени с начала _Clock эпохи, после которого время выполнения функции истечет.

_Abs_time
Момент времени, после которого выполнение функции будет прервано.

Возвращаемое значение

Возвращает:

1. std::future_status::deferred Если связанная асинхронная операция не выполняется.

2. std::future_status::ready Если связанная асинхронная операция завершена.

3. std::future_status::timeout если указанный период времени истек.

~completion_future

Уничтожает completion_future объект.

Синтаксис

~completion_future();

См. также

Пространство имен "Concurrency" (C++ AMP)