Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
HP.com home

HP C++ User Documentation

 

wclog (3C++std) - Tru64 UNIX

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(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
About PDF files: The PDF files on this site can be read online or printed using Adobe® Acrobat® Reader. If you do not have this software on your system, you may download it from Adobe's website.
Privacy statement Using this site means you accept its terms C++ support
© 2008 Hewlett-Packard Development Company, L.P.