std::future::get

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Thread support library

Threads
thread (C++11)
this_thread namespace
get_id (C++11) yield (C++11)	sleep_for (C++11) sleep_until (C++11)
Mutual exclusion
mutex (C++11) timed_mutex (C++11)	recursive_mutex (C++11) recursive_timed_mutex (C++11)
Generic lock management
lock_guard (C++11) unique_lock (C++11) defer_lock_t try_to_lock_t adopt_lock_t (C++11) (C++11) (C++11)	lock (C++11) try_lock (C++11) defer_lock try_to_lock adopt_lock (C++11) (C++11) (C++11)
Condition variables
condition_variable (C++11)
condition_variable_any (C++11)
notify_all_at_thread_exit (C++11)
cv_status (C++11)
Futures
promise (C++11) future (C++11) shared_future (C++11) packaged_task (C++11) async (C++11)	launch (C++11) future_status (C++11) future_error (C++11) future_category (C++11) future_errc (C++11)

 

std::future

future::future

future::~future

future::operator=

future::share

Getting the result

future::get

State

future::valid

future::wait

future::wait_for

future::wait_until

 

T get();	(1)	(member only of generic future template) (since C++11)
T& get();	(2)	(member only of future<T&> template specialization) (since C++11)
void get();	(3)	(member only of future<void> template specialization) (since C++11)

Waits until the result is ready in the shared state, then retrieves it. Effectively calls wait() in order to wait for the result.

Each of the three versions of the functions are available only in the generic template and two template specializations respectively. They differ only in the return type.

valid() == false after a call to this function.

Parameters

(none)

Return value

1) The value stored in the shared state. If it satisfies the requirements of MoveAssignable, the value is moved, otherwise it is copied.

2) Reference to the value in the shared state.

3) Nothing.

Exceptions

The stored exception, if any.

See also

valid	checks if the result is available (public member function)