fgets, fgetws
Nach oben zu stdio.h - Index
Header-Datei
stdio.h
Kategorie
Eingabe-/Ausgaberoutinen
Prototyp
char *fgets(char *s, int n, FILE *stream);
wchar_t *fgetws(wchar_t *s, int n, FILE *stream); // Unicode-Version
Beschreibung
Liest einen String aus einem Stream.
fgets liest Zeichen aus dem Stream in den String s. Die Funktion beendet das Lesen, wenn entweder n - 1 Zeichen gelesen wurden oder das Zeilenendezeichen angetroffen wird. fgets speichert das Zeilenendezeichen am Ende von s. Ein Null-Byte wird an s angehängt, um das Ende des Strings zu markieren.
Rückgabewert
Bei erfolgreicher Ausführung gibt fgets den String zurück, auf den s zeigt. Wurde das Dateiende erreicht oder trat ein Fehler auf, wird NULL zurückgegeben.
Beispiel
#include <string.h>
#include <stdio.h>
int main(void)
{
FILE *stream;
char string[] = "This is a test";
char msg[20];
/* Datei für Aktualisierung öffnen */
stream = fopen("DUMMY.FIL", "w+");
/* Einen String in die Datei schreiben */
fwrite(string, strlen(string), 1, stream);
/* Auf Dateianfang zurücksetzen */
fseek(stream, 0, SEEK_SET);
/* Einen String aus der Datei lesen */
fgets(msg, strlen(string)+1, stream);
/* Den String anzeigen */
printf("%s", msg);
fclose(stream);
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
fgets |
+ |
+ |
+ |
+ |
fgetws |
+ |
+ |
+ |