io_service::executor

io_service::executor_type::defer

Request the io_service to invoke the given function object.

template<
    typename Function,
    typename Allocator>
void defer(
    Function && f,
    const Allocator & a);

This function is used to ask the io_service to execute the given function object. The function object will never be executed inside defer(). Instead, it will be scheduled to run on the io_service.

If the current thread belongs to the io_service, defer() will delay scheduling the function object until the current thread returns control to the pool.

Parameters

f

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();

a

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