std::promise::promise

 

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::promise

Member functions

promise::promise

promise::~promise

promise::operator=

promise::swap

Getting the result

promise::get_future

Setting the result

promise::set_value

promise::set_value_at_thread_exit

promise::set_exception

promise::set_exception_at_thread_exit

 

promise();	(1)	(since C++11)
template< class Alloc > promise( std::allocator_arg_t, const Alloc& alloc );	(2)	(since C++11)
promise( promise&& other );	(3)	(since C++11)
promise( const promise& other ) = delete;	(4)	(since C++11)

Constructs a promise object.

1) Default constructor. Constructs the promise with an empty shared state.

2) Constructs the promise with an empty shared state. The shared state is allocated using alloc. Alloc must meet the requirements of Allocator.

3) Move constructor. Constructs the promise with the shared state of other using move semantics. other is in valid, but undefined state afterwards.

4) promise is not copyable.

Parameters

alloc	-	allocator to use to allocate the shared state
other	-	another promise to acquire the state from

Exceptions

1-2) (none)

3)

noexcept specification:  

noexcept

  (since C++11)