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 an older version of Boost and was released in 2020. The current version is 1.89.0.

static_buffer_base::prepare

static_buffer_base::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. Memory may be reallocated as needed. All buffers sequences previously obtained using data or prepare are invalidated.

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.