Standard C++ LibraryCopyright 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(3C++std), iostream(3C++std), basic_filebuf(3C++std),
  cin(3C++std), cout(3C++std), cerr(3C++std), clog(3C++std), wcout(3C++std),
  wcerr(3C++std), wclog(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.2

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement