##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::future::share

From cppreference.com
< cpp‎ | thread‎ | future

std::shared_future<T> share(); |  |

Transfers the shared state of *this to a std::shared_future object. Multiple std::shared_future objects may reference the same shared state, which is not possible with std::future.

After calling `share` on a std::future, valid() == false.

The behavior is undefined if valid()== false before the call to this function.

### [edit] Parameters

(none)

### [edit] Return value

A std::shared_future object containing the shared state previously held by *this

### [edit] Notes

The implementations are encouraged to detect the case when valid == false before the call and throw a future_error with an error condition of future_errc::no_state.

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

shared_future (C++11) | waits for a value (possibly referenced by other futures) that is set asynchronously (class template) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/thread/future/share&oldid=59170"
Category:

- Todo no example