fgetc, fgetwc
Liest ein Zeichen aus einem Stream.
Syntax
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
Parameter
stream
Zeiger zur FILE -Struktur.
Rückgabewert
fgetc gibt das gelesene Zeichen als int zurück oder gibt EOF zurück, um einen Fehler oder ein Dateiende anzugeben. fgetwc gibt als ein wint_tbreites Zeichen zurück, das dem Lese- oder WEOF Rückgabezeichen des Zeichens entspricht, um einen Fehler oder ein Ende der Datei anzugeben. Verwenden Sie für beide Funktionen feof oder ferror, um zwischen einem Fehler und einer Dateiendebedingung zu unterscheiden. Wenn ein Lesefehler auftritt, wird der Fehlerindikator für den Stream festgelegt. Ist stream das NULLfgetc der Parameter, und fgetwc rufen Sie den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein und geben EOF zurück.
Hinweise
Jede dieser Funktionen liest ein einzelnes Zeichen aus der aktuellen Position der stream zugeordneten Datei. Die Funktion erhöht dann den zugeordneten Dateizeiger (sofern definiert), um auf das nächste Zeichen zu zeigen. Wenn der Stream am Dateiende ist, wird der Dateiende-Indikator für den Stream festgelegt.
fgetc entspricht getc, wird jedoch ausschließlich als Funktion, und nicht als Funktion und Makro implementiert.
fgetwc ist die Breitzeichenversion von fgetc; sie liest c als Multibyte-Zeichen oder ein breites Zeichen, wenn stream sie im Textmodus oder binärmodus geöffnet wird.
Die Versionen mit dem Suffix _nolock sind identisch, allerdings sind sie nicht vor Störungen durch andere Threads geschützt.
Weitere Informationen zum Verarbeiten von breiten Zeichen und Multibytezeichen in Text- und Binärmodi finden Sie unter Unicode-Datenstrom-E/A in Text- und Binärmodi.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Mapping generischer Textroutinen
| TCHAR.H-Routine | _UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_fgettc |
fgetc |
fgetc |
fgetwc |
Anforderungen
| Funktion | Erforderlicher Header |
|---|---|
fgetc |
<stdio.h> |
fgetwc |
<stdio.h> oder <wchar.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
char buffer[81];
int i, ch;
// Open file to read line from:
fopen_s( &stream, "crt_fgetc.txt", "r" );
if( stream == NULL )
exit( 0 );
// Read in first 80 characters and place them in "buffer":
ch = fgetc( stream );
for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
{
buffer[i] = (char)ch;
ch = fgetc( stream );
}
// Add null to end string
buffer[i] = '\0';
printf( "%s\n", buffer );
fclose( stream );
}
Eingabe: crt_fgetc.txt
Line one.
Line two.
Output
Line one.
Line two.