...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Get a list of buffers that represents the output sequence, with the given size.
mutable_buffers_type prepare( std::size_t n);
Ensures that the output sequence can accommodate n
characters,
reallocating character array objects as necessary.
An object of type mutable_buffers_type
that satisfies MutableBufferSequence
requirements, representing character array objects at the start of the
output sequence such that the sum of the buffer sizes is n
.
If size() + n > max_size()
.
The returned object is invalidated by any basic_streambuf
member function that modifies the input sequence or output sequence.