home | help
std::future::share(3)	       C++ Standard Libary	   std::future::share(3)

NAME
     std::future::share - std::future::share

Synopsis
	std::shared_future<T> share() noexcept;

	Transfers the shared state of *this, if any, to a std::shared_future ob-
     ject.
	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	retroac-
     tively to
	previously published C++ standards.

	   DR	  Applied  to	  Behavior as published 	     Correct be-
     havior
	LWG 2556 C++11	    share() requires valid() to be  requirement  removed
     and made
			    true			   noexcept

See also
	shared_future  waits  for a value (possibly referenced by other futures)
     that is set
	(C++11)       asynchronously
		      (class template)

Category:
	  * Todo no example

http://cppreference.com 	   2024.06.10		   std::future::share(3)

home | help