wcerr(3C++) - wcerr(3C++)
Standard C++ Library Copyright 1998, Rogue Wave Software, Inc.
NAMEwcerr
- 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 associ‐
ated with the object stderr declared in <cstdio>. By default the stan‐
dard C and C++ streams are synchronized, but you can improve perfor‐
mance by using the ios_base member function synch_with_stdio to desyn‐
chronize 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 manipulators. 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
Rogue Wave Software 02 Apr 1998 wcerr(3C++)