...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Returns a mutable buffer sequence representing writable bytes.
mutable_buffers_type prepare( std::size_t n);
Returns a mutable buffer sequence representing the writable bytes containing
exactly n
bytes of storage.
This function does not allocate memory. Instead, the storage comes from
the underlying mutable buffer sequence. All buffer sequences previously
obtained using buffers_adaptor::prepare
are invalidated. Buffer
sequences previously obtained using buffers_adaptor::data
remain valid.
Name |
Description |
---|---|
|
The desired number of bytes in the returned buffer sequence. |
Type |
Thrown On |
---|---|
|
if |
Strong guarantee.