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 an old version of Boost. Click here to view this page for the latest version.
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