...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Submits a completion token or function object for execution.
template< typename CompletionToken> DEDUCED post( CompletionToken && token);
This function submits an object for execution using the object's associated
executor. The function object is queued for execution, and is never called
from the current thread prior to returning from post()
.
The use of post()
, rather than defer
, indicates the caller's preference that the function object be eagerly
queued for execution.
This function has the following effects:
Handler
,
initialized with handler(forward<CompletionToken>(token))
.
result
of type async_result<Handler>
,
initializing the object as result(handler)
.
ex
by
performing get_associated_executor(handler)
.
alloc
by performing get_associated_allocator(handler)
.
ex.post(std::move(handler), alloc)
.
result.get()
.