// // Copyright (c) 2013-2016 Vinnie Falco (vinnie dot falco at gmail dot com) // // Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // #ifndef BEAST_BIND_HANDLER_HPP #define BEAST_BIND_HANDLER_HPP #include #include #include #include #include #include namespace beast { namespace detail { /* Nullary handler that calls Handler with bound arguments. The bound handler provides the same io_service execution guarantees as the original handler. */ template class bound_handler { private: using args_type = std::tuple...>; Handler h_; args_type args_; template static void invoke(Handler& h, Tuple& args, std::index_sequence ) { h(std::get(args)...); } public: using result_type = void; template explicit bound_handler(DeducedHandler&& handler, Args&&... args) : h_(std::forward(handler)) , args_(std::forward(args)...) { } void operator()() { invoke(h_, args_, std::index_sequence_for ()); } void operator()() const { invoke(h_, args_, std::index_sequence_for ()); } friend void* asio_handler_allocate( std::size_t size, bound_handler* h) { return boost_asio_handler_alloc_helpers:: allocate(size, h->h_); } friend void asio_handler_deallocate( void* p, std::size_t size, bound_handler* h) { boost_asio_handler_alloc_helpers:: deallocate(p, size, h->h_); } friend bool asio_handler_is_continuation(bound_handler* h) { return boost_asio_handler_cont_helpers:: is_continuation (h->h_); } template friend void asio_handler_invoke(F&& f, bound_handler* h) { boost_asio_handler_invoke_helpers:: invoke(f, h->h_); } }; } // detail //------------------------------------------------------------------------------ /** Bind parameters to a completion handler, creating a wrapped handler. This function creates a new handler which invoked with no parameters calls the original handler with the list of bound arguments. The passed handler and arguments are forwarded into the returned handler, which provides the same `io_service` execution guarantees as the original handler. Unlike `io_service::wrap`, the returned handler can be used in a subsequent call to `io_service::post` instead of `io_service::dispatch`, to ensure that the handler will not be invoked immediately by the calling function. Example: @code template void do_cancel(AsyncReadStream& stream, ReadHandler&& handler) { stream.get_io_service().post( bind_handler(std::forward(handler), boost::asio::error::operation_aborted, 0)); } @endcode @param handler The handler to wrap. @param args A list of arguments to bind to the handler. The arguments are forwarded into the returned */ template #if GENERATING_DOCS implementation_defined #else detail::bound_handler, Args...> #endif bind_handler(CompletionHandler&& handler, Args&&... args) { return detail::bound_handler, Args...>(std::forward< CompletionHandler>(handler), std::forward(args)...); } } // beast namespace std { template void bind(beast::detail::bound_handler< Handler, Args...>, ...) = delete; } // std #endif