Standard C++ Library
Copyright 1998, Rogue Wave Software, Inc.

NAME

 
ostrstream
 
 - Writes to an array in memory.
 
 
 

SYNOPSIS

 
 
#include <strstream>
class ostrstream
: public basic_ostream<char>
 
 
 

DESCRIPTION

 
 
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<char> and therefore can use all the formatted and unformatted output functions.
 
This is a deprecated feature and might not be available in future versions.
 
 
 

INTERFACE

 
 
 
class ostrstream
: public basic_ostream<char> {
 
public:
 

typedef char_traits<char>             traits;

typedef char                         char_type;
typedef typename traits::int_type    int_type;
typedef typename traits::pos_type    pos_type;
typedef typename traits::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;

 
};
 
 
 

TYPES

 
 
 
char_type

 
 
The type char_type is a synonym of type char. 
 

 
 
int_type

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

 
 
off_type

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

 
 
pos_type

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

 
 
traits

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

CONSTRUCTORS

 
 
 
ostrstream();

 
 
Constructs an object of class ostrstream, initializing the base class basic_ostream<char> 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<char> 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)).RE
 

DESTRUCTORS

virtual ~ostrstream();

 
 
Destroys an object of class ostrstream. 
 

MEMBER FUNCTIONS

 
 
 
void
freeze(bool freezefl = 1);

 
 
If the mode is dynamic, alters the freeze status of the dynamic array object as follows:
 

-If freezefl is false, the function sets the freeze status to frozen. 

-Otherwise, it clears the freeze status..RE
 

 
int
pcount() const;

 
 
Returns the size of the output sequence.
 

 
 
strstreambuf∗
rdbuf() const;

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

 
 
char∗
str();

 
 
Returns a pointer to the underlying array object, which may be null.
 

EXAMPLE

 
 
See strstream, istrstream and strstreambuf examples.
 
 
 

SEE ALSO

 
 
char_traits(3C++), ios_base(3C++), basic_ios(3C++), strstreambuf(3C++), istrstream(3C++), strstream(3C++)
 
Working Paper for Draft Proposed International Standard for Information Systems--Programming Language C++, Annex D Compatibility features Section D.6.3
 
 
 

STANDARDS CONFORMANCE

 
 
ANSI X3J16/ISO WG21 Joint C++ Committee
 

Rogue Wave Software  —  Last change: 02 Apr 1998