Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the develop branch, built from commit 0f95d64ff2.
PrevUpHomeNext
buffers_adaptor::prepare

Returns a mutable buffer sequence representing writable bytes.

Synopsis
mutable_buffers_type
prepare(
    std::size_t n);
Description

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.


PrevUpHomeNext