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

Exceptions

Exception Safety

Strong guarantee.