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 initial-
ized 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 initial-
ized 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 Com-
patibility features Section D.6.3
STANDARDS CONFORMANCE
ANSI X3J16/ISO WG21 Joint C++ Committee