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		+	+	+