HP C++ User Documentation

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

NAME

  basic_iostream,iostream

  This page describes the ANSI basic_iostream class.  If you would like
  information on the pre-ANSI iostream class, use the command:

       man 3C++ iostream or man iostream.3C++

SYNOPSIS

  #include <istream>
  template<class charT, class traits = char_traits<charT> >
  class basic_iostream
  : public basic_istream<charT, traits>,
  public basic_ostream<charT, traits>

DESCRIPTION

  The class basic_iostream inherits a number of functions from classes
  basic_ostream<charT, traits> and basic_istream<charT, traits>. They assist
  in formatting and interpreting sequences of characters controlled by a
  stream buffer. Two groups of functions share common properties, the
  formatted functions and the unformatted functions.

INTERFACE

  template<class charT, class traits>
  class basic_iostream
  : public basic_istream<charT, traits>,
   public basic_ostream<charT, traits>

  {

  public:

   explicit basic_iostream(basic_streambuf<charT, traits> *sb);
   virtual ~basic_iostream();

  protected:

   explicit basic_iostream();

  };

PUBLIC CONSTRUCTORS

  explicit basic_iostream(basic_streambuf<charT, traits>* sb);
     Constructs an object of class basic_iostream, assigning initial values
     to the base class by calling basic_istream<charT, traits>(sb) and
     basic_ostream<charT, traits>(sb).

  explicit basic_iostream();
     Constructs an object of class basic_iostream, assigning initial values
     to the base class by calling basic_istream<charT, traits>() and
     basic_ostream<charT, traits>(). After construction the object has its
     badbit set.

DESTRUCTOR

  virtual ~basic_iostream();
     Destroys an object of class basic_iostream.

EXAMPLES

  See basic_istream and basic_ostream examples.

COMPATIBILITY

  [Digital]  The ANSI Standard Library provides two macros which enable or
  disable use of the ANSI iostream package at compile time.

  ______________________________________________________________
  Macro                   Description
  ______________________________________________________________
  __USE_STD_IOSTREAM      Use the ANSI Standard iostream package
  __NO_USE_STD_IOSTREAM   Use the pre-ANSI iostream package
  ______________________________________________________________

  See ios_intro(3C++) or iostream_intro(3C++std) for more details.

SEE ALSO

  char_traits(3C++std), ios_base(3C++std), basic_ios(3C++std),
  basic_streambuf(3C++std), basic_istream(3C++std), basic_ostream(3C++std)

  Working Paper for Draft Proposed International Standard for Information
  Systems--Programming Language C++, Section 27.6.1.4.1

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee