std::basic_spanbuf

template< 
    class CharT, 
    class Traits = std::char_traits<CharT>
> class basic_spanbuf : public std::basic_streambuf<CharT, Traits>

std::basic_spanbuf is a std::basic_streambuf whose associated character sequence is a memory-resident sequence of arbitrary characters, which can be initialized from or made available as an instance of std::span<CharT>.

std::basic_spanbuf performs I/O on a fixed buffer, and therefore it does not attempt to obtain a new buffer when the underlying buffer is exhausted.

Typical implementations of std::basic_spanbuf add two member subobjects: a std::ios_base::openmode recording the open mode, and a std::span<CharT> referencing the underlying buffer.

Several typedefs for common character types are provided:

Member types

Member functions

Non-member functions

Notes

std::basic_spanbuf does not own the underlying buffer.

It is the responsibility of programmers to ensure the underlying buffer is in its lifetime when used by a std::basic_spanbuf object. Additional synchronization may be needed if more than one thread operates the same underlying buffer through different std::basic_spanbuf objects.

See also