dpp::moveable_promise< T > Class Template Reference

Generic promise class, represents the owning potion of an asynchronous value. More...

Public Member Functions
awaitable< T >	get_awaitable ()
	Get an awaitable object for this promise. More...
void	notify_awaiter ()
	Notify a currently awaiting coroutine that the result is ready. More...
template<bool Notify = true, typename... Args>
	requires (std::constructible_from< T, Args... >) void emplace_value(Args &&... args)
template<bool Notify = true>
void	set_exception (std::exception_ptr ptr)
template<bool Notify = true>
void	set_value () requires(std
template<bool Notify = true, typename U = T>
void	set_value (U &&v) requires(std

Detailed Description

template<typename T>
class dpp::moveable_promise< T >

Generic promise class, represents the owning potion of an asynchronous value.

This class is roughly equivalent to std::promise, with the crucial distinction that the promise IS the shared state. As such, the promise needs to be kept alive for the entire time a value can be retrieved.

The difference between basic_promise and this object is that this one is moveable as it wraps an underlying basic_promise in a std::unique_ptr.

See also

awaitable

Member Function Documentation

get_awaitable()

template<typename T >

awaitable<T> dpp::moveable_promise< T >::get_awaitable ( )

inline

Get an awaitable object for this promise.

Exceptions

dpp::logic_exception

if get_awaitable has already been called on this object.

Returns

awaitable<T> An object that can be co_await-ed to retrieve the value of this promise.

notify_awaiter()

template<typename T >

void dpp::moveable_promise< T >::notify_awaiter ( )

inline

Notify a currently awaiting coroutine that the result is ready.

Note

This may resume the coroutine on the current thread.

Exceptions

?	Any exception thrown by the coroutine if resumed will propagate

requires()

template<typename T >

template<bool Notify = true, typename... Args>

dpp::moveable_promise< T >::requires ( std::constructible_from< T, Args... >  ) &&

inline

set_exception()

template<typename T >

template<bool Notify = true>

void dpp::moveable_promise< T >::set_exception ( std::exception_ptr  ptr )

inline

set_value() [1/2]

template<typename T >

template<bool Notify = true>

void dpp::moveable_promise< T >::set_value ( )

inline

set_value() [2/2]

template<typename T >

template<bool Notify = true, typename U = T>

void dpp::moveable_promise< T >::set_value ( U &&  v )

inline