Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.


Specifies the cin global stream.

extern istream cin;

An istream object.

The object controls extractions from the standard input as a byte stream. Once the object is constructed, the call cin.tie returns &cout.

In this example, cin sets the fail bit on the stream when it encounters non-numeric characters. The program clears the fail bit and strips the invalid character from the stream to proceed.

// iostream_cin.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main()
   int x;
   cout << "enter choice:";
   cin >> x;
   while (x < 1 || x > 4)
      cout << "Invalid choice, try again:";
      cin >> x;
      // not a numeric character, probably
      // clear the failure and pull off the non-numeric character
      if (cin.fail())
         char c;
         cin >> c;



Header: <iostream>

Community Additions

© 2015 Microsoft