Standard C++ LibraryCopyright 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(3C++std), iostream(3C++std), basic_filebuf(3C++std),
  cout(3C++std), cin(3C++std), cerr(3C++std), clog(3C++std), wcin(3C++std),
  wcout(3C++std), wcerr(3C++std), iomanip(3C++std), ios_base(3C++std),
  basic_ios(3C++std)

  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