...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Request the strand to invoke the given handler.
template< typename CompletionHandler> void dispatch( CompletionHandler handler);
This function is used to ask the strand to execute the given handler.
The strand object guarantees that handlers posted or dispatched through the strand will not be executed concurrently. The handler may be executed inside this function if the guarantee can be met. If this function is called from within a handler that was posted or dispatched through the same strand, then the new handler will be executed immediately.
The strand's guarantee is in addition to the guarantee provided by the
underlying io_service
. The io_service
guarantees that the
handler will only be called in a thread in which the io_service's run member
function is currently being invoked.
The handler to be called. The strand will make a copy of the handler object as required. The function signature of the handler must be:
void handler();