buffers_adaptor::prepare

Returns a mutable buffer sequence representing writable bytes.

Synopsis

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 prepare are invalidated. Buffer sequences previously obtained using data remain valid.

Parameters

Name	Description
`n`	The desired number of bytes in the returned buffer sequence.

Exceptions

Type	Thrown On
`std::length_error`	if `size()` + n exceeds `max_size()`.

Exception Safety

Strong guarantee.