Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::experi...ture::future(3) C++ Standard Libarystd::experi...ture::future(3)

NAME
       std::experimental::future::future - std::experimental::future::future

Synopsis
	  future()						     noexcept;
       (1)
	  future(std::experimental::future<T>&&		 f)	     noexcept;
       (2)
	  future(const	    std::experimental::future<T>&)	=      delete;
       (3)
	  future(std::experimental::future<std::experimental::future<T>>    &&
       other)	     (4)
	  noexcept;

	  1)  Default constructor. Constructs an empty future object that does
       not refer to a
	  shared state.
	  2) Constructs	a future object, transferring the shared state held by
       f, if any.
	  After	construction, f.valid()	is false.
	  3) Copy constructor is deleted. future cannot	be copied.
	  4) Unwrapping	constructor.  Constructs  a  future  object  from  the
       shared state referred
	  to  by  other, if any. If other.valid() == false prior to this call,
       the constructed
	  future object	is empty. Otherwise, the resulting future  object  be-
       comes ready when
	  one of the following happens:

	    *  other  and  other.get()	are both ready.	The value or exception
       from other.get()	is
	      stored in	the shared state associated with the resulting	future
       object.
	    * other is ready, but other.get() is invalid. An exception of type
	      std::future_error	  with	 an   error   condition	  of  std::fu-
       ture_errc::broken_promise is
	      stored in	the shared state associated with the resulting	future
       object.

	  After	 this  constructor  returns,  valid() is equal to the value of
       other.valid() prior
	  to this call,	and other.valid() == false.

Parameters
	  f	- another future object	to initialize with
	  other	- A std::experimental::future object to	unwrap

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 behavior
	  LWG  2697  Concurrency  TS  behavior	of  unwrapping	constructor is
       constructs an empty
				  unclear with an invalid future	   fu-
       ture

See also
	  constructor	constructs the future object
			(public	member function	of std::future<T>)

http://cppreference.com		  2022.07.31	 std::experi...ture::future(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::experimental::future::future&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help