|
(Deprecated: Use post.)
Request the io_context
to invoke the given handler and return immediately.
template<
typename LegacyCompletionHandler>
DEDUCED post(
LegacyCompletionHandler && handler);
This function is used to ask the io_context
to execute the given handler, but without allowing the io_context
to call the handler from inside this function.
The io_context
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 to be called. The io_context
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.