Skip to content. Skip to navigation

ICTP Portal

You are here: Home Manuals on-line PGI Compiler pgC_lib cin
Personal tools
Document Actions


Click on the banner to return to the class reference home page.


Pre-defined stream

Data Type and Member Function Indexes
(exclusive of constructors and destructors)



#include <iostream>
extern istream cin;


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 synchronized, 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.


// 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

  // 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(3C++), basic_filebuf(3C++), cout(3C++), cerr(3C++), clog(3C++), wcin(3C++), wcout(3C++), wcerr(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.1

Standards Conformance

ANSI X3J16/ISO WG21 Joint C++ Committee

©Copyright 1996, Rogue Wave Software, Inc.

Powered by Plone This site conforms to the following standards: