Annex D (normative) Compatibility features [depr]

D.15 char* streams [depr.str.strstreams]

D.15.5 Class strstream [depr.strstream]

D.15.5.1 General [depr.strstream.general]

namespace std { class strstream : public basic_iostream<char> { public: // types using char_type = char; using int_type = char_traits<char>::int_type; using pos_type = char_traits<char>::pos_type; using off_type = char_traits<char>::off_type; // constructors/destructor strstream(); strstream(char* s, int n, ios_base::openmode mode = ios_base::in|ios_base::out); virtual ~strstream(); // members strstreambuf* rdbuf() const; void freeze(bool freezefl = true); int pcount() const; char* str(); private: strstreambuf sb; // exposition only }; }

The class strstream supports reading and writing from objects of class strstreambuf.

It supplies a strstreambuf object to control the associated array object.

For the sake of exposition, the maintained data is presented here as:

(1.1)
sb, the strstreambuf object.

D.15.5.2 strstream constructors [depr.strstream.cons]

🔗

strstream();

Effects: Initializes the base class with iostream(&sb).

🔗

strstream(char* s, int n,
          ios_base::openmode mode = ios_base::in|ios_base::out);

Effects: Initializes the base class with iostream(&sb), and sb with one of the two constructors:

(2.1)
If (mode & app) == 0, then s shall designate the first element of an array of n elements.

The constructor is strstreambuf(s,n,s).
(2.2)
If (mode & app) != 0, then s shall designate the first element of an array of n elements that contains an ntbs whose first element is designated by s.

The constructor is strstreambuf(s,n,s + std::strlen(s)).

D.15.5.3 strstream destructor [depr.strstream.dest]

🔗

virtual ~strstream();

Effects: Destroys an object of class strstream.

D.15.5.4 strstream operations [depr.strstream.oper]

🔗

strstreambuf* rdbuf() const;

Returns: const_cast<strstreambuf*>(&sb).

🔗

void freeze(bool freezefl = true);

Effects: Calls rdbuf()->freeze(freezefl).

🔗

char* str();

Returns: rdbuf()->str().

🔗

int pcount() const;

Returns: rdbuf()->pcount().