cppdraft_translate/cppdraft/ospanstream.md

[ospanstream]

31 Input/output library [input.output]

31.9 Span-based streams [span.streams]

31.9.5 Class template basic_ospanstream [ospanstream]

31.9.5.1 General [ospanstream.general]

🔗

namespace std {template<class charT, class traits = char_traits>class basic_ospanstream : public basic_ostream<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; // [ospanstream.cons], constructorsexplicit basic_ospanstream(std::span s, ios_base::openmode which = ios_base::out); basic_ospanstream(const basic_ospanstream&) = delete; basic_ospanstream(basic_ospanstream&& rhs);

basic_ospanstream& operator=(const basic_ospanstream&) = delete; basic_ospanstream& operator=(basic_ospanstream&& rhs); // [ospanstream.swap], swapvoid swap(basic_ospanstream& rhs); // [ospanstream.members], member functions 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.5.2 Constructors [ospanstream.cons]

🔗

explicit basic_ospanstream(std::span<charT> s, ios_base::openmode which = ios_base::out);

1

#

Effects: Initializes the base class withbasic_ostream<charT, traits>(addressof(sb)) and sb withbasic_spanbuf<charT, traits>(s, which | ios_base​::​out) ([spanbuf.cons]).

🔗

basic_ospanstream(basic_ospanstream&& rhs) noexcept;

2

#

Effects: Initializes the base class with std​::​move(rhs) and sb with std​::​move(rhs.sb).

Next, basic_ostream<charT, traits>​::​set_rdbuf(addressof(sb)) is called to install the contained basic_spanbuf.

31.9.5.3 Swap [ospanstream.swap]

🔗

void swap(basic_ospanstream& rhs);

1

#

Effects: Equivalent to:basic_ostream<charT, traits>::swap(rhs);sb.swap(rhs.sb);

🔗

template<class charT, class traits> void swap(basic_ospanstream<charT, traits>& x, basic_ospanstream<charT, traits>& y);

2

#

Effects: Equivalent to x.swap(y).

31.9.5.4 Member functions [ospanstream.members]

🔗

basic_spanbuf<charT, traits>* rdbuf() const noexcept;

1

#

Effects: Equivalent to:return const_cast<basic_spanbuf<charT, traits>*>(addressof(sb));

🔗

std::span<charT> span() const noexcept;

2

#

Effects: Equivalent to: return rdbuf()->span();

🔗

void span(std::span<charT> s) noexcept;

3

#

Effects: Equivalent to rdbuf()->span(s).