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 2023. The current version is 1.90.0.

buffer_ref::prepare

buffer_ref::prepare

Get a list of buffers that represents the output sequence, with the given size.

Synopsis

mutable_buffers_type
prepare(
    std::size_t n);

Description

Ensures that the output sequence can accommodate n bytes, resizing the vector object as necessary.

Return Value

An object of type mutable_buffers_type that satisfies MutableBufferSequence requirements, representing vector memory at the start of the output sequence of size n.

Exceptions

Type	Thrown On
`std::length_error`	If `size()` + n > `max_size()`.

Remarks

The returned object is invalidated by any dynamic_vector_buffer or vector member function that modifies the input sequence or output sequence.