4.0 KiB
[spanstream]
31 Input/output library [input.output]
31.9 Span-based streams [span.streams]
31.9.6 Class template basic_spanstream [spanstream]
31.9.6.1 General [spanstream.general]
namespace std {template<class charT, class traits = char_traits>class basic_spanstream : public basic_iostream<charT, traits> {public:using char_type = charT; using int_type = typename traits::int_type; using pos_type = typename traits::pos_type; using off_type = typename traits::off_type; using traits_type = traits; // [spanstream.cons], constructorsexplicit basic_spanstream(std::span s, ios_base::openmode which = ios_base::out | ios_base::in); basic_spanstream(const basic_spanstream&) = delete; basic_spanstream(basic_spanstream&& rhs);
basic_spanstream& operator=(const basic_spanstream&) = delete; basic_spanstream& operator=(basic_spanstream&& rhs); // [spanstream.swap], swapvoid swap(basic_spanstream& rhs); // [spanstream.members], members basic_spanbuf<charT, traits>* rdbuf() const noexcept;
std::span span() const noexcept; void span(std::span s) noexcept; private: basic_spanbuf<charT, traits> sb; // exposition only};}
31.9.6.2 Constructors [spanstream.cons]
explicit basic_spanstream(std::span<charT> s, ios_base::openmode which = ios_base::out | ios_bas::in);
Effects: Initializes the base class withbasic_iostream<charT, traits>(addressof(sb)) and sb withbasic_spanbuf<charT, traits>(s, which) ([spanbuf.cons]).
basic_spanstream(basic_spanstream&& rhs);
Effects: Initializes the base class with std::move(rhs) and sb with std::move(rhs.sb).
Next, basic_iostream<charT, traits>::set_rdbuf(addressof(sb)) is called to install the contained basic_spanbuf.
31.9.6.3 Swap [spanstream.swap]
void swap(basic_spanstream& rhs);
Effects: Equivalent to:basic_iostream<charT, traits>::swap(rhs);sb.swap(rhs.sb);
template<class charT, class traits> void swap(basic_spanstream<charT, traits>& x, basic_spanstream<charT, traits>& y);
Effects: Equivalent to x.swap(y).
31.9.6.4 Member functions [spanstream.members]
basic_spanbuf<charT, traits>* rdbuf() const noexcept;
Effects: Equivalent to:return const_cast<basic_spanbuf<charT, traits>*>(addressof(sb));
std::span<charT> span() const noexcept;
Effects: Equivalent to: return rdbuf()->span();
void span(std::span<charT> s) noexcept;
Effects: Equivalent to rdbuf()->span(s).