cpp/io/basic stringbuf/view

Creates and returns a std over the underlying character sequence.
 * For input-only streams, the returned view represents the range.
 * For input/output or output-only streams, references the characters from to the last character in the sequence regardless of  and.
 * If the stream is neither input nor output, returns.

The member character sequence in a buffer open for writing can be over-allocated for efficiency purposes. In that case, only the initialized characters are referenced: these characters are the ones that were obtained from the string argument of the constructor, the string argument used by the most recent call to a setter overload of, or from a write operation. A typical implementation that uses over-allocation maintains a high-watermark pointer to track the end of the initialized part of the buffer and the returned view references the characters from to the high-watermark pointer.

Parameters
(none)

Return value
A view over the underlying character sequence.