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

 NAME

   cerr

 SYNOPSIS

   #include <iostream>
   extern ostream cerr;

   DESCRIPTION
   ostream cerr;

   The object	cerr controls output to	an unbuffered stream buffer
   associated with the object stderr declared in
   <cstdio>. By default, the standard C and	C++ streams are
   synchronized, but you may improve performance by	using the
   ios_base member function synch_with_stdio to desynchronize them.

 FORMATTING

   The formatting is done through member	functions or manipulators. See
   cout or basic_ostream for details.

 EXAMPLES

   //
   // cerr example
   //
   #include<iostream>
   #include<fstream>

   void main ( )
   {
    using namespace std;

     // open the	file "file_name.txt"
     // for reading
    ifstream in("file_name.txt");

     // output the all file to stdout
    if (	in )
      cout << in.rdbuf();
    else
       // if the	ifstream object	is in a	bad state
       // output	an error message to stderr
      cerr << "Error while opening the file" << endl;
   }

 SEE ALSO

   basic_ostream, iostream, basic_filebuf,
   cout, cin, clog, wcin, wcout,
   wcerr, wclog, iomanip, ios_base,
   basic_ios

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

 STANDARDS CONFORMANCE
   ANSI X3J16/ISO WG21 Joint C++	Committee