asio C++ library

io_service::strand::dispatch (1 of 2 overloads)

Request the strand to invoke the given function object.

    typename Function,
    typename Allocator>
void dispatch(
    Function && f,
    const Allocator & a);

This function is used to ask the strand to execute the given function object on its underlying io_service. The function object will be executed inside this function if the strand is not otherwise busy and if the underlying io_service's executor's dispatch() function is also able to execute the function before returning.



The function object to be called. The executor will make a copy of the handler object as required. The function signature of the function object must be:

void function();


An allocator that may be used by the executor to allocate the internal storage needed for function invocation.