Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of boost. Click here for the latest Boost documentation.


Request the io_context to invoke the given function object.

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

This function is used to ask the io_context to execute the given function object. If the current thread is running the io_context, dispatch() executes the function before returning. Otherwise, the function will be scheduled to run on the io_context.



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.