Namespaces
Variants

std::promise<R>:: get_future

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11) (C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++26) (C++26)
(C++26) (C++26)
(C++11)
(C++20) (C++20)
(C++20)
(C++20)
Free functions for atomic flags
(C++11) (C++11)
(C++11) (C++11)
(C++20) (C++20)
(C++20) (C++20)
(C++20)
(C++20)
std::promise
std:: future < R > get_future ( ) ;
(начиная с C++11)

Возвращает объект future, связанный с тем же общим состоянием, что и * this .

Исключение выбрасывается, если * this не имеет общего состояния или get_future уже был вызван. Чтобы получить несколько "выходных" концов канала связи promise-future, используйте std::future::share .

Вызовы этой функции не создают состояний гонки данных с вызовами set_value , set_exception , set_value_at_thread_exit или set_exception_at_thread_exit (следовательно, они не требуют синхронизации друг с другом).

Параметры

(нет)

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

Будущее, ссылающееся на общее состояние * this .

Исключения

std::future_error при следующих условиях:

  • * this не имеет общего состояния. Код ошибки установлен в no_state .
  • get_future() уже был вызван для promise с тем же общим состоянием, что и * this . Код ошибки устанавливается в future_already_retrieved .