...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Create a new modifiable buffer that represents the given string.
template< typename Elem, typename Traits, typename Allocator> mutable_buffer buffer( std::basic_string< Elem, Traits, Allocator > & data, std::size_t max_size_in_bytes);
A mutable_buffer
value equivalent to:
mutable_buffer( data.size() ? &data[0] : 0, min(data.size() * sizeof(Elem), max_size_in_bytes));
The buffer is invalidated by any non-const operation called on the given string object.