wcout

Pre-defined stream

• Data Type and Member Function Indexes
• Synopsis
• Description
• Formatting
• Description
• Default Values
• Examples
• Warnings
• See Also
• Standards Conformance

None

#include <iostream>
extern wostream wcout;

wostream wcout;

The object wcout controls output to a stream buffer associated with the object stdout declared in <cstdio>. By default the standard C and C++ streams are synchronized, but performance can be improved by using the ios_base member function synch_with_stdio to desynchronize them.

After the object wcin is initialized, wcin.tie() returns &wcout, which implies that wcin and wcout are synchronized. wcout uses the locale codecvt facet to convert the wide characters it receives to the tiny characters it outputs to stdout.

The formatting is done through member functions or manipulators.

precision()            6
width()                0
fill()                 the space character
flags()                skipws | dec
getloc()               locale::locale()

//
// wcout example one
//
#include<iostream>
#include<iomanip>

void main ( )
{
  using namespace std; 

  int i;
  float f;
  
  // read an integer and a float from stdin
  cin >> i >> f;

  // output the integer and goes at the line
  wcout << i << endl;

  // output the float and goes at the line
  wcout << f << endl;   

  // output i in hexa
  wcout << hex << i << endl;

  // output i in octal and then in decimal
  wcout << oct << i << dec << i << endl;  

  // output i preceded by its sign
  wcout << showpos << i << endl;

  // output i in hexa
  wcout << setbase(16) << i << endl;

  // output i in dec and pad to the left with character
  // @ until a width of 20
  // if you input 45 it outputs 45@@@@@@@@@@@@@@@@@@ 
  wcout << setfill(L'@') << setw(20) << left << dec << i;
  wcout << endl;

  // output the same result as the code just above
  // but uses member functions rather than manipulators
  wcout.fill('@');
  wcout.width(20);
  wcout.setf(ios_base::left, ios_base::adjustfield);
  wcout.setf(ios_base::dec, ios_base::basefield);
  wcout << i << endl; 

  // outputs f in scientific notation with
  // a precision of 10 digits
  wcout << scientific << setprecision(10) << f << endl;

  // change the precision to 6 digits
  // equivalents to wcout << setprecision(6);
  wcout.precision(6);

  // output f and goes back to fixed notation
  wcout << f << fixed << endl;
  
}

//
// wcout example two
//
#include <iostream>

void main ( )
{
  using namespace std;

  wchar_t p[50];

  wcin.getline(p,50);

  wcout << p;   
}

//
// wcout example three
//
#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
    { 
      wcout << "Error while opening the file";  
      wcout << endl;
    }
}

Keep in mind that the manipulator endl flushes the stream buffer. Therefore it is recommended to use L'\n' if your only intent is to go at the line. It will greatly improve performance when C and C++ streams are not synchronized.

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

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

ANSI X3J16/ISO WG21 Joint C++ Committee

©Copyright 1996, Rogue Wave Software, Inc.