forked from boostorg/beast
buffer_cat now determines if all of the buffer sequences in the list of passed buffer sequences each have value types which are convertible to mutable_buffer. The returned concatenated sequence will be a MutableBufferSequence if all the passed buffer sequences meet the requirements of MutableBufferSequence, else the returned concatenated sequence will be a ConstBufferSequence.
58 lines
1.8 KiB
C++
58 lines
1.8 KiB
C++
//
|
|
// 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_BUFFER_CAT_HPP
|
|
#define BEAST_BUFFER_CAT_HPP
|
|
|
|
#include <beast/core/detail/buffer_cat.hpp>
|
|
#include <boost/asio/buffer.hpp>
|
|
#include <cstdint>
|
|
#include <iterator>
|
|
#include <new>
|
|
#include <stdexcept>
|
|
#include <tuple>
|
|
#include <utility>
|
|
|
|
namespace beast {
|
|
|
|
/** Concatenate 2 or more buffer sequences.
|
|
|
|
This function returns a constant or mutable buffer sequence which,
|
|
when iterated, efficiently concatenates the input buffer sequences.
|
|
Copies of the arguments passed will be made; however, the returned
|
|
object does not take ownership of the underlying memory. The application
|
|
is still responsible for managing the lifetime of the referenced memory.
|
|
|
|
@param buffers The list of buffer sequences to concatenate.
|
|
|
|
@return A new buffer sequence that represents the concatenation of
|
|
the input buffer sequences. This buffer sequence will be a
|
|
@b MutableBufferSequence if each of the passed buffer sequences is
|
|
also a @b MutableBufferSequence, else the returned buffer sequence
|
|
will be a @b ConstBufferSequence.
|
|
*/
|
|
#if GENERATING_DOCS
|
|
template<class... BufferSequence>
|
|
implementation_defined
|
|
buffer_cat(BufferSequence const&... buffers)
|
|
#else
|
|
template<class B1, class B2, class... Bn>
|
|
detail::buffer_cat_helper<B1, B2, Bn...>
|
|
buffer_cat(B1 const& b1, B2 const& b2, Bn const&... bn)
|
|
#endif
|
|
{
|
|
static_assert(
|
|
detail::is_all_ConstBufferSequence<B1, B2, Bn...>::value,
|
|
"BufferSequence requirements not met");
|
|
return detail::buffer_cat_helper<
|
|
B1, B2, Bn...>{b1, b2, bn...};
|
|
}
|
|
|
|
} // beast
|
|
|
|
#endif
|