fread

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

size_t fread(void *ptr, size_t size, size_t n, FILE *stream);

Beschreibung

Liest Daten aus einem Stream.

fread liest n Datenelemente der Größe length aus dem angegebenen Eingabe-Stream in den Block, auf den ptr zeigt.

Die Gesamtzahl der gelesenen Bytes ist (n * size).

Rückgabewert

Wenn erfolgreich, gibt fread die Zahl der gelesenen Elemente (nicht der Bytes) zurück.

Wurde das Dateiende erreicht oder trat ein Fehler auf, wird die Anzahl der bis dahin gelesenen Elemente (möglicherweise 0) zurückgegeben.

Beispiel

 #include <string.h>
 #include <stdio.h>
 int main(void)
 {
    FILE *stream;
    char msg[] = "this is a test";
    char buf[20];
    if ((stream = fopen("DUMMY.FIL", "w+"))
        == NULL)
    {
       fprintf(stderr, "Cannot open output file.\n");
       return 1;
    }
    /* einige Daten in die Datei schreiben */
    fwrite(msg, strlen(msg)+1, 1, stream);
    /* auf Dateianfang zurücksetzen */
    fseek(stream, SEEK_SET, 0);
    /* Daten lesen und anzeigen */
    fread(buf, strlen(msg)+1, 1, stream);
    printf("%s\n", buf);
    fclose(stream);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
+	+	+	+