std::getchar
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
C-style I/O
Types and objects
Functions
File access
Direct input/output
Unformatted input/output
Formatted input
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
Formatted output
(C++11)
(C++11)
File positioning
Error handling
Operations on files
Defined in header
<cstdio>
int getchar();
Reads the next character from stdin .
Equivalent to std::getc (stdin).
Contents
[edit] Parameters
(none)
[edit] Return value
The obtained character on success or EOF on failure.
If the failure has been caused by end of file condition, additionally sets the eof indicator (see std::feof() ) on stdin . If the failure has been caused by some other error, sets the error indicator (see std::ferror() ) on stdin .
[edit] Example
std::getchar with error checking. Exit program by entering ESC char.
#include <cctype> #include <cstdio> #include <cstdlib> #include <iomanip> #include <iostream> int main() { for (int ch; (ch = std::getchar()) != EOF ;) // read/print "abc" from stdin { if (std::isprint (ch)) std::cout << static_cast<char>(ch) << '\n'; if (ch == 27) // 'ESC' (escape) in ASCII return EXIT_SUCCESS ; } // Test reason for reaching EOF. if (std::feof (stdin)) // if failure caused by end-of-file condition std::cout << "End of file reached\n"; else if (std::ferror (stdin)) // if failure caused by some other error { std::perror ("getchar()"); std::cerr << "getchar() failed in file " << std::quoted (__FILE__) << " at line # " << __LINE__ - 14 << '\n'; std::exit (EXIT_FAILURE ); } return EXIT_SUCCESS ; }
Possible output:
abc a b c ^[
[edit] See also
C documentation for getchar