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

 NAME

   wclog

 SYNOPSIS

   #include <iostream>
   extern wostream wclog;

 DESCRIPTION

   wostream wclog;
      The object	wclog controls output to a stream buffer associated
      with the object stderr declared in <cstdio>. The difference
      between	wclog and wcerr is that wclog is buffered, but wcerr
      isn't .	Therefore, commands like wclog	<< L"ERROR !!";	and
      fprintf(stderr,"ERROR !!");	are not	synchronized.	 wclog
      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 manipulators. See
   cout, wcout	or basic_ostream for details.

 EXAMPLES

   //
   // wclog 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
      wclog << L"Error while opening the	file" << endl;
   }

 WARNINGS

   wclog	can be used to redirect	some of	the errors to another
   recipient. For example, you might want to redirect them to a	file
   named my_err:

   wofstream out("my_err");

   if ( out )
    wclog.rdbuf(out.rdbuf());
   else
    cerr	<< "Error while	opening	the file" << endl;

   Then when you	are doing something like wclog << L"error number x";
   the error	message	is output to the file my_err.  Obviously, you
   can use the same scheme to redirect wclog	to other devices.

 SEE ALSO

   basic_ostream, iostream, basic_filebuf,
   cout, cin, cerr, clog, wcin,
   wcout, wcerr, 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