Namensräume
Varianten
Aktionen

std::getchar

Von cppreference.com
< cpp‎ | io‎ | c
 
 
 
C-Style I/O
Typen und Objekte
Funktionen
Datei-Zugriff
Direkte Ein-/Ausgabe
Unformatierte Ein-/Ausgabe
Formatierte Eingabe
(C++11)(C++11)(C++11)    
(C++11)(C++11)(C++11)    
 
Definiert in Header <cstdio>
int getchar();

Liest das nächste Zeichen von stdin.

Äquivalent zu std::getc(stdin).

Inhalt

[edit] Parameter

(keine)

[edit] Rückgabewert

Das erfolgreich gelesene Zeichen oder EOF im Fehlerfall.

Wenn der Fehler durch eine End-of-File-Bedingung verursacht wurde, wird zusätzlich die eof-Anzeige (siehe std::feof()) auf stdin gesetzt. Wenn der Fehler durch einen anderen Fehler verursacht wurde, wird die error-Anzeige (siehe std::ferror()) auf stdin gesetzt.

[edit] Beispiel

std::getchar mit Fehlerprüfung. Programm beenden durch Eingabe des ESC-Zeichens.

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

Mögliche Ausgabe

abc
a
b
c
^[

[edit] Siehe auch

liest ein Zeichen aus einem Dateistream
(function) [bearbeiten]
C-Dokumentation für getchar