Man Page wcerr.3

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

NAME

     wcerr

      - Controls output to an unbuffered stream buffer associated
     with the object stderr declared in <cstdio>.

SYNOPSIS

     #include <iostream>
     extern wostream wcerr;
     wostream wcerr;

DESCRIPTION

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

     wcerr uses the locale codecvt  facet  to  convert  the  wide
     characters  it receives to the tiny characters it outputs to
     stderr.

FORMATTING

     The formatting is done through member functions or manipula-
     tors. See cout, wcout, or basic_ostream for details.

EXAMPLE

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

     void main ( )
     {
      using namespace std;

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

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

SEE ALSO

     basic_ostream(3C++),                   basic_iostream(3C++),
     basic_filebuf(3C++),   cout(3C++),   cin(3C++),  cerr(3C++),
     clog(3C++),    wcin(3C++),     wcout(3C++),     wclog(3C++),
     ios_base(3C++), basic_ios(3C++)

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

STANDARDS CONFORMANCE

     ANSI X3J16/ISO WG21 Joint C++ Committee