FutureBase Class Reference

Classes
struct	moving_init_t

Public Types
enum

Public Member Functions
bool	valid () const noexcept
bool	is_ready () const
bool	has_value () const
bool	has_exception () const
std::exception_ptr	get_exception_ptr () const
FutureStatus::Enum	wait (int timeoutInMs) const

Protected Member Functions
	FutureBase ()
	FutureBase (const FutureBase &other) noexcept
FutureBase &	operator= (const FutureBase &other) noexcept
	FutureBase (FutureBase &&other) noexcept
FutureBase &	operator= (FutureBase &&other) noexcept
	FutureBase (const System::FutureSharedState *state) noexcept
	FutureBase (const System::FutureSharedState *state, moving_init_t) noexcept
	~FutureBase () noexcept
void	swap (FutureBase &other) noexcept
const void *	getValuePtr () const
void	getVoid () const

Friends
class	FutureHelper

Detailed Description

Definition at line 57 of file Future.h.

Member Enumeration Documentation

anonymous enum

anonymous enum

Enumerator
InfiniteTimeout	-1

Definition at line 101 of file Future.h.

Constructor & Destructor Documentation

FutureBase() [1/5]

FutureBase ( )

inlineprotected

Definition at line 112 of file Future.h.

FutureBase() [2/5]

FutureBase ( const FutureBase & other )

protectednoexcept

FutureBase() [3/5]

FutureBase ( FutureBase && other )

protectednoexcept

FutureBase() [4/5]

FutureBase ( const System::FutureSharedState * state )

protectednoexcept

Initializes the instance with shared state.

FutureBase() [5/5]

FutureBase ( const System::FutureSharedState * state, moving_init_t  )

protectednoexcept

Initializes the instance with shared state.

~FutureBase()

~FutureBase ( )

protectednoexcept

Destroys a future object.

If this is the last reference to the asynchronous result associated with *this (if any), then destroy that asynchronous result.

Member Function Documentation

get_exception_ptr()

std::exception_ptr get_exception_ptr

(

)

const

Returns the stored exception.

Exceptions

std::logic_error	if this instance does not refer to a shared state.
std::logic_error	if the operation has not finished with an error.

getValuePtr()

const void * getValuePtr ( ) const

protected

getVoid()

void getVoid ( ) const

protected

has_exception()

bool has_exception

(

)

const

Returns true if the asynchronous result associated with this Future has a stored exception, false otherwise.

Exceptions

std::logic_error

if this instance does not refer to a shared state.

has_value()

bool has_value

(

)

const

Returns true if the asynchronous result associated with this Future has a stored value, false otherwise.

Exceptions

std::logic_error

if this instance does not refer to a shared state.

is_ready()

bool is_ready

(

)

const

Returns true if the asynchronous result associated with this Future is ready (has a value or exception stored in the shared state), false otherwise.

There are often situations where a get() call on a Future may not be a blocking call, or is only a blocking call under certain circumstances. This method gives the ability to test for early completion and allows us to avoid associating a continuation, which needs to be scheduled with some non-trivial overhead and near-certain loss of cache efficiency.

Exceptions

std::logic_error

if this instance does not refer to a shared state.

operator=() [1/2]

FutureBase & operator= ( const FutureBase & other )

protectednoexcept

operator=() [2/2]

FutureBase & operator= ( FutureBase && other )

protectednoexcept

swap()

void swap ( FutureBase & other )

protectednoexcept

valid()

bool valid ( ) const

inlinenoexcept

Check if a future instance is associated with an asynchronous result.

Returns true if the *this has an associated asynchronous result, false otherwise.

Definition at line 63 of file Future.h.

wait()

FutureStatus::Enum wait

(

int

timeoutInMs

)

const

Waits for the result to become available during the timeout.

Note

Calling wait on the same Future from multiple threads is not safe; the intended use is for each thread that waits on the same shared state to have a copy of a Future.

Exceptions

std::logic_error

if this instance does not refer to a shared state.

Friends And Related Symbol Documentation

FutureHelper

friend class FutureHelper

friend

Definition at line 149 of file Future.h.