std::future<T>::share
std::shared_future<T> share() noexcept; |
||
Transfers the shared state of *this, if any, 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.
Parameters
(none)
Return value
A std::shared_future object containing the shared state previously held by *this, if any, constructed as if by std::shared_future<T>(std:move(*this)).
Example
This section is incomplete Reason: no example |
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 2556 | C++11 | share() requires valid() to be true
|
requirement removed and made noexcept
|
See also
(C++11) |
waits for a value (possibly referenced by other futures) that is set asynchronously (class template) |