Annex D (normative) Compatibility features [depr]

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

D.6.3 Class ostrstream [depr.ostrstream]

namespace std {
  class ostrstream : public basic_ostream<char> {
  public:
    ostrstream();
    ostrstream(char* s, int n, ios_base::openmode mode = ios_base::out);
    virtual ~ostrstream();

    strstreambuf* rdbuf() const;
    void freeze(bool freezefl = true);
    char* str();
    int pcount() const;
  private:
    strstreambuf sb;  // exposition only
  };
}
1
#
The class ostrstream supports the writing of 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.6.3.1 ostrstream constructors [depr.ostrstream.cons]

ostrstream();
1
#
Effects: Constructs an object of class ostrstream, initializing the base class with ostream(&sb) and initializing sb with strstreambuf().
ostrstream(char* s, int n, ios_base::openmode mode = ios_base::out);
2
#
Effects: Constructs an object of class ostrstream, initializing the base class with ostream(&sb), and initializing sb with one of 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)).333
333)
The function signature strlen(const char*) is declared in <cstring> ([cstring.syn]).

D.6.3.2 Member functions [depr.ostrstream.members]

strstreambuf* rdbuf() const;
1
#
Returns: (strstreambuf*)&sb.
void freeze(bool freezefl = true);
2
#
Effects: Calls rdbuf()->freeze(freezefl).
char* str();
3
#
Returns: rdbuf()->str().
int pcount() const;
4
#
Returns: rdbuf()->pcount().