mirror of
https://github.com/Xahau/xahaud.git
synced 2025-12-06 17:27:52 +00:00
d8dea963fa
6d5547a Set version to 1.0.0-b34 6fab138 Fix and tidy up CMake build scripts: ccefa54 Set version to 1.0.0-b33 32afe41 Set internal state correctly when writing frames: fe3e20b Add write_frames unit test 578dcd0 Add decorator unit test aaa3733 Use fwrite return value in file_body df66165 Require Visual Studio 2015 Update 3 or later b8e5a21 Set version to 1.0.0-b32 ffb1758 Update CMake scripts for finding packages: b893749 Remove http Writer suspend and resume feature (API Change): 27864fb Add io_service completion invariants tests eba05a7 Set version to 1.0.0-b31 484bcef Fix badge markdown in README.md 5663bea Add missing dynabuf_readstream member 0d7a551 Tidy up build settings 0fd4030 Move the handler, don't copy it git-subtree-dir: src/beast git-subtree-split: 6d5547a32c50ec95832c4779311502555ab0ee1f
89 lines
2.9 KiB
C++
89 lines
2.9 KiB
C++
//
|
|
// Copyright (c) 2013-2017 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_ASYNC_COMPLETION_HPP
|
|
#define BEAST_ASYNC_COMPLETION_HPP
|
|
|
|
#include <beast/config.hpp>
|
|
#include <beast/core/handler_concepts.hpp>
|
|
#include <boost/asio/async_result.hpp>
|
|
#include <boost/asio/handler_type.hpp>
|
|
#include <type_traits>
|
|
#include <utility>
|
|
|
|
namespace beast {
|
|
|
|
/** Helper for customizing the return type of asynchronous initiation functions.
|
|
|
|
This class template is used to transform caller-provided completion
|
|
handlers in calls to asynchronous initiation functions. The transformation
|
|
allows customization of the return type of the initiating function, and the
|
|
function signature of the final handler.
|
|
|
|
@tparam CompletionHandler A completion handler, or a user defined type
|
|
with specializations for customizing the return type (for example,
|
|
`boost::asio::use_future` or `boost::asio::yield_context`).
|
|
|
|
@tparam Signature The callable signature of the final completion handler.
|
|
|
|
Example:
|
|
@code
|
|
...
|
|
template<class CompletionHandler>
|
|
typename async_completion<CompletionHandler,
|
|
void(error_code)>::result_type
|
|
async_initfn(..., CompletionHandler&& handler)
|
|
{
|
|
async_completion<CompletionHandler,
|
|
void(error_code)> completion{handler};
|
|
...
|
|
return completion.result.get();
|
|
}
|
|
@endcode
|
|
|
|
@note See <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3896.pdf">
|
|
Library Foundations For Asynchronous Operations</a>
|
|
*/
|
|
template<class CompletionHandler, class Signature>
|
|
struct async_completion
|
|
{
|
|
/** The type of the final handler called by the asynchronous initiation function.
|
|
|
|
Objects of this type will be callable with the specified signature.
|
|
*/
|
|
using handler_type =
|
|
typename boost::asio::handler_type<
|
|
CompletionHandler, Signature>::type;
|
|
|
|
/// The type of the value returned by the asynchronous initiation function.
|
|
using result_type = typename
|
|
boost::asio::async_result<handler_type>::type;
|
|
|
|
/** Construct the helper.
|
|
|
|
@param token The completion handler. Copies will be made as
|
|
required. If `CompletionHandler` is movable, it may also be moved.
|
|
*/
|
|
async_completion(typename std::remove_reference<CompletionHandler>::type& token)
|
|
: handler(std::forward<CompletionHandler>(token))
|
|
, result(handler)
|
|
{
|
|
static_assert(is_CompletionHandler<handler_type, Signature>::value,
|
|
"Handler requirements not met");
|
|
}
|
|
|
|
/// The final completion handler, callable with the specified signature.
|
|
handler_type handler;
|
|
|
|
/// The return value of the asynchronous initiation function.
|
|
boost::asio::async_result<handler_type> result;
|
|
};
|
|
|
|
} // beast
|
|
|
|
#endif
|