fgetwc, getwc

 

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 <wchar.h>
wint_t fgetwc( FILE *stream );		(seit C95)
wint_t getwc( FILE *stream );		(seit C95)

Liest das nächste Wide-Zeichen aus dem gegebenen Eingabestream. getwc() kann als Makro implementiert sein und stream mehr als einmal auswerten.

Parameter

stream

-

Der Stream, aus dem das Wide-Zeichen gelesen werden soll

Rückgabewert

Das nächste Wide-Zeichen aus dem Stream oder WEOF bei einem Fehler.

Wenn der Fehler durch eine End-of-File-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.

Wenn ein Kodierungsfehler aufgetreten ist, wird zusätzlich errno auf EILSEQ gesetzt.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <errno.h>
#include <locale.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    FILE *fp = fopen("fgetwc.dat", "w");
    if(!fp) {
        perror("Can't open file for writing");
        return EXIT_FAILURE;
    }
    fputs("кошка\n", fp);
    fclose(fp);
 
    fp = fopen("fgetwc.dat", "r");
    if(!fp) {
        perror("Can't open file for reading");
        return EXIT_FAILURE;
    }
    wint_t wc;
    errno = 0;
    while ((wc = fgetwc(fp)) != WEOF)
        putwchar(wc);
 
    if (ferror(fp)) {
        if (errno == EILSEQ)
            puts("Character encoding error while reading.");
        else
            puts("I/O error when reading");
    } else if (feof(fp))
        puts("End of file reached successfully");
 
    fclose(fp);
}

Ausgabe

кошка

Referenzen

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

• 7.29.3.1 Die Funktion fgetwc (S. 307-308)

• 7.29.3.6 Die Funktion getwc (S. 309)

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

• 7.29.3.1 Die Funktion fgetwc (S. 421-422)

• 7.29.3.6 Die Funktion getwc (S. 424)

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

• 7.24.3.1 Die Funktion fgetwc (S. 367)

• 7.24.3.6 Die Funktion getwc (S. 369)

Siehe auch

fgetcgetc	liest ein Zeichen aus einem Dateistream (Funktion)
fgetws (C95)	liest einen Weitzeichenstring aus einem Dateistream (Funktion)
fputwcputwc (C95)	schreibt ein Weitzeichen in einen Dateistream (Funktion)
ungetwc (C95)	gibt ein Weitzeichen zurück in einen Dateistream (Funktion)
C++ Dokumentation für fgetwc