Class used to specify that an asynchronous operation should return a future. More...

#include <use_future.hpp>

Public Types
typedef Allocator	allocator_type

Public Member Functions
ASIO_CONSTEXPR	use_future_t ()
	Construct using default-constructed allocator. More...

	use_future_t (const Allocator &allocator)
	Construct using specified allocator. More...

template<typename OtherAllocator >
use_future_t< OtherAllocator >	operator[] (const OtherAllocator &allocator) const
	Specify an alternate allocator. More...

allocator_type	get_allocator () const
	Obtain allocator. More...

Detailed Description

template<typename Allocator = std::allocator<void>>
class asio::use_future_t< Allocator >

Class used to specify that an asynchronous operation should return a future.

The use_future_t class is used to indicate that an asynchronous operation should return a std::future object. A use_future_t object may be passed as a handler to an asynchronous operation, typically using the special value asio::use_future. For example:

std::future<std::size_t> my_future

= my_socket.async_read_some(my_buffer, asio::use_future);

The initiating function (async_read_some in the above example) returns a future that will receive the result of the operation. If the operation completes with an error_code indicating failure, it is converted into a system_error and passed back to the caller via the future.

Definition at line 41 of file use_future.hpp.