fgetc, getc

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Datei-Ein-/Ausgabe

Typen und Objekte
stdinstdoutstderr          FILE fpos_t
Funktionen Datei-Zugriff fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush Unformatierte Ein-/Ausgabe fgetc fgets fputc fputs getchar getsgets_s (bis C11)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) Formatierte Eingabe scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	Direkte Ein-/Ausgabe fread fwrite Formatierte Ausgabe printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

Definiert in Header <stdio.h>
int fgetc( FILE* stream );	(1)
int getc( FILE* stream );	(2)

1) Liest das nächste Zeichen aus dem gegebenen Eingabestrom.

2) Gleiche Funktion wie fgetc, mit der Ausnahme, dass wenn getc als Makro implementiert ist, es den stream mehr als einmal auswerten kann. Daher sollte das entsprechende Argument niemals ein Ausdruck mit Seiteneffekten sein.

Parameter

stream

-

um das Zeichen zu lesen aus

Rückgabewert

Bei Erfolg wird das erhaltene Zeichen als unsigned char, konvertiert zu einem int, zurückgegeben. Bei einem Fehler wird EOF zurückgegeben.

Wenn der Fehler durch eine Dateiende-Bedingung verursacht wurde, wird zusätzlich der eof-Indikator (siehe feof()) für stream gesetzt. Wenn der Fehler durch einen anderen Fehler verursacht wurde, wird der error-Indikator (siehe ferror()) für stream gesetzt.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char* fname = "/tmp/unique_name.txt"; // or tmpnam(NULL);
    int is_ok = EXIT_FAILURE;
 
    FILE* fp = fopen(fname, "w+");
    if (!fp)
    {
        perror("File opening failed");
        return is_ok;
    }
    fputs("Hello, world!\n", fp);
    rewind(fp);
 
    int c; // note: int, not char, required to handle EOF
    while ((c = fgetc(fp)) != EOF) // standard C I/O file reading loop
        putchar(c);
 
    if (ferror(fp))
        puts("I/O error when reading");
    else if (feof(fp))
    {
        puts("End of file is reached successfully");
        is_ok = EXIT_SUCCESS;
    }
 
    fclose(fp);
    remove(fname);
    return is_ok;
}

Mögliche Ausgabe

Hello, world!
End of file is reached successfully

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.21.7.1 Die Funktion fgetc (p: TBD)

• 7.21.7.5 Die Funktion getc (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.21.7.1 Die Funktion fgetc (p: 240-241)

• 7.21.7.5 Die Funktion getc (p: 242)

• C11-Standard (ISO/IEC 9899:2011)

• 7.21.7.1 Die Funktion fgetc (p: 330)

• 7.21.7.5 Die Funktion getc (p: 332)

• C99-Standard (ISO/IEC 9899:1999)

• 7.19.7.1 Die Funktion fgetc (p: 296)

• 7.19.7.5 Die Funktion getc (p: 297-298)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.9.7.1 Die Funktion fgetc

• 4.9.7.5 Die Funktion getc

Siehe auch

getchar	liest ein Zeichen aus stdin (Funktion)
getsgets_s (entfernt in C11)(C11)	liest einen Zeichenstring aus stdin (Funktion)
fputcputc	schreibt ein Zeichen in einen Dateistream (Funktion)
ungetc	gibt ein Zeichen zurück in einen Dateistream (Funktion)
C++-Dokumentation für fgetc, getc