basic_istream::peek
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. ArchiveDisclaimer

basic_istream::peek

Returns the next character to be read.

int_type peek( );

Return Value

The next character that will be read.

Remarks

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

Example

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

Input

abcde

Sample Output

Type 'abcde': abcde
a abcde

See Also

basic_istream Class | basic_istream Members

Show:
© 2016 Microsoft