ostrstream

Module:  Standard C++ Library   Library:  Input/output

ostrstream  basic_ostream  basic_ios  ios_base 

• Local Index
• Summary
• Synopsis
• Description
• Interface
• Member Types
• Constructors
• Destructors
• Member Functions
• Example
• See Also
• Standards Conformance

Members

char_type freeze() int_type

off_type ostrstream() pcount()

pos_type rdbuf() str()

traits_type ~ostrstream()

Writes to an array in memory

#include <strstream> 

namespace std {
  class ostrstream;
}

The class ostrstream writes to an array in memory. It uses a private strstreambuf object to control the associated array object. It inherits from basic_ostream, and therefore can use all the formatted and unformatted output functions.

---

NOTE -- This is a deprecated feature and might not be available in future versions.

---

namespace std {

  class ostrstream 
  : public basic_ostream<char> {

    public:

    typedef char                           char_type;
    typedef char_traits<char_type>         traits_type;
    typedef typename traits_type::int_type int_type;
    typedef typename traits_type::pos_type pos_type;
    typedef typename traits_type::off_type off_type;

    ostrstream();
    ostrstream(char *s, int n,
               ios_base::openmode = ios_base::out);
    
    virtual ~ostrstream();

    strstreambuf *rdbuf() const;
    void freeze(int freezefl = 1);
    char *str();
    int pcount() const;

  };
}

char_type

The type char_type is a synonym of type char.

int_type

The type int_type is a synonym of type traits_type::in_type.

off_type

The type off_type is a synonym of type traits_type::off_type.

pos_type

The type pos_type is a synonym of type traits_type::pos_type.

traits_type

The type traits_type is a synonym of type char_traits<char>.

ostrstream();

Constructs an object of class ostrstream, initializing the base class basic_ostream with the associated strstreambuf object. The strstreambuf object is initialized by calling its default constructor strstreambuf().

ostrstream(char* s, int n, ios_base::openmode
           mode = ios_base::out); 

Constructs an object of class ostrstream, initializing the base class basic_ostream with the associated strstreambuf object. The strstreambuf object is initialized by calling one of two constructors:

• If mode & app == 0, it calls strstreambuf(s,n,s)

• Otherwise it calls strstreambuf(s,n,s + ::strlen(s))

virtual ~ostrstream();

Destroys an object of class ostrstream.

void 
freeze(bool freezefl = true); 

Calls rdbuf()->freeze(freezefl).

int 
pcount() const; 

Returns rdbuf()->pcount().

strstreambuf* 
rdbuf() const; 

Returns a pointer to the private strstreambuf object associated with the stream.

char* 
str();

Returns rdbuf()->str().

See examples for strstream, istrstream, and strstreambuf.

char_traits, ios_base, basic_ios, strstreambuf, istrstream, strstream

Deprecated. See ISO/IEC 14882:1998 -- International Standard for Information Systems --Programming Language C++, Annex D Compatibility features Section D.7.3

Copyright (c) 1994-2006 Rogue Wave Software, a Quovadx Division.
Licensed under the Apache License, Version 2.0.
Contact Rogue Wave about documentation or support issues. You can also seek help from other developers through the Apache stdcxx community (see below).