std::getchar - cppreference.com (original) (raw)

| | | | | -------------- | | | | int getchar(); | | |

Reads the next character from stdin.

Equivalent to std::getc(stdin).

[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 #include #include #include #include   int main() { for (int ch; (ch = std::getchar()) != EOF ;) // read/print "abc" from stdin { if (std::isprint(ch)) std::cout << static_cast(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:

[edit] See also