CKTIS / C
fread — C23-streamfunctie
`fread(ptr, size, nmemb, stream)` uit `<stdio.h>` probeert `nmemb` elementen van `size` bytes in `ptr` te lezen en retourneert het aantal volledige elementen. Data is een reeks `unsigned char`; een korte telling betekent einde of fout.
Versie: C23
Syntax
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) uit <stdio.h> probeert nmemb elementen van size bytes in ptr te lezen en retourneert het aantal volledige elementen. Data is een reeks unsigned char; een korte telling betekent einde of fout.
Het voorbeeld bewaart vijf bytes ABCDE en vraagt tweemaal drie. 3 2 1 ABC DE toont een volledige eerste leesactie, twee bytes in de tweede en een gezette einde-indicator.
Het doel moet size * nmemb bevatten; bereken zonder overflow. Bij size == 0 of nmemb == 0 volgt nul zonder array of streamtoestand te wijzigen. Gebruik na een korte telling feof en ferror; gebruik alleen volledige elementen, want een deelelement telt niet mee.
Voorbeelden
#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;}
Resultaat
3 2 1 ABC DE
Het voorbeeld bewaart vijf bytes `ABCDE` en vraagt tweemaal drie. `3 2 1 ABC DE` toont een volledige eerste leesactie, twee bytes in de tweede en een gezette einde-indicator.