WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

fread — C23-Datenstromfunktion

`fread(ptr, size, nmemb, stream)` aus `<stdio.h>` versucht `nmemb` Elemente zu je `size` Bytes in `ptr` zu lesen und liefert die Zahl vollständig gelesener Elemente. Daten werden als `unsigned char`-Folge behandelt; ein kurzer Wert bedeutet Ende oder Fehler.

Version: C23

Syntax

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

fread(ptr, size, nmemb, stream) aus <stdio.h> versucht nmemb Elemente zu je size Bytes in ptr zu lesen und liefert die Zahl vollständig gelesener Elemente. Daten werden als unsigned char-Folge behandelt; ein kurzer Wert bedeutet Ende oder Fehler.

Das Beispiel speichert fünf Bytes ABCDE und fordert zweimal drei an. 3 2 1 ABC DE zeigt vollständiges erstes Lesen, zwei verfügbare Bytes beim zweiten und eine gesetzte Dateiendeanzeige.

Das Ziel muss size * nmemb aufnehmen; Kapazität ohne Überlauf berechnen. Bei size == 0 oder nmemb == 0 wird null geliefert, Array und Stromzustand bleiben. Nach kurzem Ergebnis feof und ferror prüfen; nur vollständige Elemente nutzen, da ein Teilelement nicht gezählt wird.

Beispiele

#include <stdio.h>
int main(void){FILE*s=tmpfile();if(!s)return 1;if(fwrite("ABCDE",1,5,s)!=5){fclose(s);return 1;}rewind(s);char a[4]={0},b[4]={0};size_t n1=fread(a,1,3,s),n2=fread(b,1,3,s);printf("%zu %zu %d %s %s\n",n1,n2,feof(s)!=0,a,b);return fclose(s)==0?0:1;}

Ergebnis

3 2 1 ABC DE

Das Beispiel speichert fünf Bytes `ABCDE` und fordert zweimal drei an. `3 2 1 ABC DE` zeigt vollständiges erstes Lesen, zwei verfügbare Bytes beim zweiten und eine gesetzte Dateiendeanzeige.

Quellen