Standard C++ LibraryCopyright 1996, Rogue Wave Software, Inc.

NAME

  ostrstream

SYNOPSIS

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

DESCRIPTION

  The class ostrstream provides functionality to write 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.

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 calls strstreambuf(s,n,s)

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

DESTRUCTOR

  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.

  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.

EXAMPLES

  See strstream, istrstream and strstreambuf examples.

SEE ALSO

  char_traits(3C++std), ios_base(3C++std), basic_ios(3C++std),
  strstreambuf(3C++std), istrstream(3C++std), strstream(3C++std)

  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



privacy and legal statement