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

 NAME

   cin

 SYNOPSIS

   #include <iostream>
   extern istream cin;

 DESCRIPTION
 istream cin;
      The object	cin controls input from	a stream buffer	associated
      with	the object stdin declared in <cstdio>.	By default,
      the	standard C and C++ streams are syn chronized, but you
      can improve performance by using	the ios_base member function
      synch_with_stdio to desynchronize	them.

      After the object cin is initialized, cin.tie() returns &cout,
      which implies that cin and cout are synchronized.

 EXAMPLES

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

   void main ( )
   {
    using namespace std;

    int i;
    float f;
    char	c;

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

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

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

   void main ( )
   {
    using namespace std;

    char	p[50];

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

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

     // output the result to stdout
    cout	<< 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,
   cout, cerr,	clog, wcin, wcout,
   wcerr, wclog, ios_base, basic_ios

   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