| Home | Libraries | People | FAQ | More

#### dynamic_string_buffer::prepare

DynamicBuffer_v1: 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` bytes, resizing the basic_string object as necessary.

###### Return Value

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

###### Exceptions

std::length_error

  If `size() + n > max_size()`.

###### Remarks

The returned object is invalidated by any `dynamic_string_buffer` or `basic_string` member function that modifies the input sequence or output sequence.