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

 NAME

   wcin

 SYNOPSIS

   #include <iostream>
   extern wistream wcin;

 DESCRIPTION

   wistream wcin;
      The object	wcin controls input from a stream buffer associated
      with the object stdin declared in <cstdio>.	By default the
      standard	C and C++ streams are synchronized, but performance
      improvement can be achieved 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. wcin	uses
      the locale codecvt facet to convert the tiny characters extracted
      from stdin to the wide characters stored in the wcin
      buffer.

 EXAMPLES

   //
   // wcin example one
   //
   #include <iostream>

   void main ( )
   {
    using namespace std;

    int i;
    float f;
    wchar_t c;

     //read an integer, a float and a wide character from stdin
    wcin	>> i >>	f >> c;

     // output i, f and c to stdout
    wcout << i << endl << f << endl << c	<< endl;
   }

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

   void main ( )
   {
    using namespace std;

    wchar_t p[50];

     // remove all the white spaces
    wcin	>> ws;

     // read characters from stdin until	a newline
     // or 49 characters	have been read
    wcin.getline(p,50);

     // output the result to stdout
    wcout << p;
   }

      When inputting "  Grendel the monster" (newline) in the previous
      test, the output	will be	"Grendel the monster". The manipulator
      ws removes spaces.

 SEE ALSO

   basic_istream, iostream, basic_filebuf,
   cin,	cout, cerr, clog, wcout,
   wcerr, wclog, ios_base, basic_ios

   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