Namespaces
Variants
Views
Actions

std::promise::set_value

From cppreference.com
< cpp‎ | thread‎ | promise
Revision as of 23:28, 31 May 2013 by P12bot (Talk | contribs)

void set_value( const R& value );
(1) (member only of generic promise template)
(since C++11)
void set_value( R&& value );
(2) (member only of generic promise template)
(since C++11)
void set_value( R& value );
(3) (member only of promise<R&> template specialization)
(since C++11)
void set_value()
(4) (member only of promise<void> template specialization)
(since C++11)

Stores the value into the shared state and makes the state ready.

The operation is atomic, i.e. it behaves as though they acquire a single mutex associated with the promise object while updating the promise object.

An exception is thrown if there is no shared state or the shared state already stores a value or exception.

Contents

Parameters

value - value to store in the shared state

Return value

(none)

Exceptions

std::future_error on the following conditions:

  • *this has no shared state. The error category is set to no_state.

Additionally:

1-2) Any exception thrown by the copy constructor of value
3) Any exception thrown by the move constructor of value

Example

See also

sets the result to indicate an exception
(public member function) [edit]