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.


Returns the next character to be read.

int_type peek( );

The next character that will be read.

The unformatted input function extracts an element, if possible, as if by returning rdbuf ->sgetc. Otherwise, it returns traits_type::eof.

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

int main( ) 
   char c[10], c2;
   cout << "Type 'abcde': ";

   c2 = cin.peek( );
   cin.getline( &c[0], 9 );

   cout << c2 << " " << c << endl;
abcdeabcdeType 'abcde': abcde a abcde

Header: <istream>

Namespace: std

Community Additions

© 2015 Microsoft