std::packaged_task<R(Args...)>::get_future

From cppreference.com
 
 
Concurrency support library
Threads
(C++11)
(C++20)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
Free functions for atomic operations
Free functions for atomic flags
Memory ordering
Mutual exclusion
(C++11)
Generic lock management
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
Semaphores
Latches and barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
 
 
std::future<R> get_future();
(since C++11)

Returns a future which shares the same shared state as *this.

get_future can be called only once for each packaged_task.

Parameters

(none)

Return value

A future which shares the same shared state as *this.

Exceptions

std::future_error on the following error conditions:

  • The shared state has already been retrieved via a call to get_future. The error category is set to future_already_retrieved.
  • *this has no shared state. The error category is set to no_state.