Boost
C++ Libraries
...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 io_service to invoke the given
handler.
template< typename CompletionHandler> void-or-deduced dispatch( CompletionHandler handler);
This function is used to ask the io_service to execute the given
handler.
The io_service
guarantees that the handler will only be called in a thread in which the
run(),
run_one(),
poll()
or poll_one()
member functions is currently being invoked. The handler may be executed
inside this function if the guarantee can be met.
The handler to be called. The io_service will make a copy
of the handler object as required. The function signature of the
handler must be:
void handler();
This function throws an exception only if:
asio_handler_allocate
function; or
throws an exception.