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
126 lines
4.3 KiB
Plaintext
126 lines
4.3 KiB
Plaintext
[/
|
|
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)
|
|
]
|
|
|
|
[section:DynamicBuffer DynamicBuffer requirements]
|
|
|
|
A dynamic buffer encapsulates memory storage that may be automatically resized
|
|
as required, where the memory is divided into an input sequence followed by an
|
|
output sequence. These memory regions are internal to the dynamic buffer, but
|
|
direct access to the elements is provided to permit them to be efficiently used
|
|
with I/O operations, such as the send or receive operations of a socket. Data
|
|
written to the output sequence of a dynamic buffer object is appended to the
|
|
input sequence of the same object.
|
|
|
|
The interface to this concept is intended to permit the following
|
|
implementation strategies:
|
|
|
|
* A single contiguous octet array, which is reallocated as necessary to
|
|
accommodate changes in the size of the octet sequence.
|
|
|
|
* A sequence of one or more octet arrays, where each array is of the same
|
|
size. Additional octet array objects are appended to the sequence to
|
|
accommodate changes in the size of the octet sequence.
|
|
|
|
* A sequence of one or more octet arrays of varying sizes. Additional octet
|
|
array objects are appended to the sequence to accommodate changes in the
|
|
size of the character sequence. This is the implementation approach
|
|
currently offered by [link beast.ref.basic_streambuf `basic_streambuf`].
|
|
|
|
In the table below:
|
|
|
|
* `X` denotes a dynamic buffer class.
|
|
* `a` denotes a value of type `X`.
|
|
* `c` denotes a (possibly const) value of type `X`.
|
|
* `n` denotes a value of type `std::size_t`.
|
|
* `T` denotes a type meeting the requirements for [@http://www.boost.org/doc/libs/1_61_0/doc/html/boost_asio/reference/ConstBufferSequence.html `ConstBufferSequence`].
|
|
* `U` denotes a type meeting the requirements for [@http://www.boost.org/doc/libs/1_61_0/doc/html/boost_asio/reference/MutableBufferSequence.html `MutableBufferSequence`].
|
|
|
|
[table DynamicBuffer requirements
|
|
[[operation] [type] [semantics, pre/post-conditions]]
|
|
[
|
|
[`X::const_buffers_type`]
|
|
[`T`]
|
|
[
|
|
This type represents the memory associated with the input sequence.
|
|
]
|
|
]
|
|
[
|
|
[`X::mutable_buffers_type`]
|
|
[`U`]
|
|
[
|
|
This type represents the memory associated with the output sequence.
|
|
]
|
|
]
|
|
[
|
|
[`c.size()`]
|
|
[`std::size_t`]
|
|
[
|
|
Returns the size, in bytes, of the input sequence.
|
|
]
|
|
]
|
|
[
|
|
[`c.max_size()`]
|
|
[`std::size_t`]
|
|
[
|
|
Returns the permitted maximum of the sum of the sizes of the input
|
|
sequence and output sequence.
|
|
]
|
|
]
|
|
[
|
|
[`c.capacity()`]
|
|
[`std::size_t`]
|
|
[
|
|
Returns the maximum sum of the sizes of the input sequence and output
|
|
sequence that the dynamic buffer can hold without requiring reallocation.
|
|
]
|
|
]
|
|
[
|
|
[`c.data()`]
|
|
[`X::const_buffers_type`]
|
|
[
|
|
Returns a constant buffer sequence u that represents the memory
|
|
associated with the input sequence, and where `buffer_size(u) == size()`.
|
|
]
|
|
]
|
|
[
|
|
[`a.prepare(n)`]
|
|
[`X::mutable_buffers_type`]
|
|
[
|
|
Returns a mutable buffer sequence u representing the output sequence,
|
|
and where `buffer_size(u) == n`. The dynamic buffer reallocates memory
|
|
as required. All constant or mutable buffer sequences previously
|
|
obtained using `data()` or `prepare()` are invalidated.
|
|
|
|
Throws: `length_error` if `size() + n` exceeds `max_size()`.
|
|
]
|
|
]
|
|
[
|
|
[`a.commit(n)`]
|
|
[ ]
|
|
[
|
|
Appends `n` bytes from the start of the output sequence to the end of
|
|
the input sequence. The remainder of the output sequence is discarded.
|
|
If `n` is greater than the size of the output sequence, the entire
|
|
output sequence is appended to the input sequence. All constant or
|
|
mutable buffer sequences previously obtained using `data()` or
|
|
`prepare()` are invalidated.
|
|
]
|
|
]
|
|
[
|
|
[`a.consume(n)`]
|
|
[ ]
|
|
[
|
|
Removes `n` bytes from beginning of the input sequence. If `n` is
|
|
greater than the size of the input sequence, the entire input sequence
|
|
is removed. All constant or mutable buffer sequences previously
|
|
obtained using `data()` or `prepare()` are invalidated.
|
|
]
|
|
]
|
|
]
|
|
|
|
[endsect]
|