Exit Zen
2
string ID 12
type: paragraph
English
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.
505/5050 · 505
3
string ID 20
type: paragraph
English
The interface to this concept is intended to permit the following implementation strategies:
92/920 · 92
4
string ID 23
type: list
English
* A single contiguous octet array, which is reallocated as necessary to
71/710 · 71
5
string ID 27
type: list
English
* A sequence of one or more octet arrays, where each array is of the same
73/730 · 73
6
string ID 31
type: list
English
* A sequence of one or more octet arrays of varying sizes. Additional octet
75/750 · 75
7
string ID 36
type: heading
English
Associated With
15/150 · 15
8
string ID 38
type: list
English
* `boost::asio::is_dynamic_buffer`
* __ConstBufferSequence__
* __MutableBufferSequence__
88/880 · 88
9
string ID 42
type: heading
English
Requirements
12/120 · 12
10
string ID 44
type: list
English
* `D` denotes a dynamic buffer class.
* `a` denotes a value of type `D`.
* `c` denotes a (possibly const) value of type `D`.
* `n` denotes a value of type `std::size_t`.
* `T` denotes a type meeting the requirements for __ConstBufferSequence__.
* `U` denotes a type meeting the requirements for __MutableBufferSequence__.
321/3210 · 321
11
string ID 51
type: table title
English
Valid expressions
17/170 · 17
14
string ID 51
type: table cell
English
Semantics, Pre/Post-conditions
30/300 · 30
17
string ID 51
type: table cell
English
This type represents the memory associated with the input sequence.
67/670 · 67
20
string ID 51
type: table cell
English
This type represents the memory associated with the output sequence.
68/680 · 68
23
string ID 51
type: table cell
English
Returns the size, in bytes, of the input sequence.
50/500 · 50
24
string ID 51
type: table cell
English
`c.max_size()`
14/140 · 14
25
string ID 51
type: table cell
English
Returns the permitted maximum of the sum of the sizes of the input sequence and output sequence.
96/960 · 96
27
string ID 51
type: table cell
English
Returns the maximum sum of the sizes of the input sequence and output sequence that the dynamic buffer can hold without requiring reallocation.
143/1430 · 143
29
string ID 51
type: table cell
English
Returns a constant buffer sequence u that represents the memory associated with the input sequence, and where `buffer_size(u) == size()`.
137/1370 · 137
31
string ID 51
type: table cell
English
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()`.
323/3230 · 323
33
string ID 51
type: table cell
English
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.
366/3660 · 366