CKTIS / C
fread — funkcija toka C23
`fread(ptr, size, nmemb, stream)` iz `<stdio.h>` poskusi prebrati `nmemb` elementov po `size` bajtov v `ptr` in vrne število popolnih elementov. Podatki so zaporedje `unsigned char`; kratek rezultat pomeni konec ali napako.
Različica: C23
Sintaksa
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) iz <stdio.h> poskusi prebrati nmemb elementov po size bajtov v ptr in vrne število popolnih elementov. Podatki so zaporedje unsigned char; kratek rezultat pomeni konec ali napako.
Primer shrani pet bajtov ABCDE in dvakrat zahteva tri. 3 2 1 ABC DE pokaže popolno prvo branje, dva bajta pri drugem in nastavljen kazalnik konca.
Cilj mora držati size * nmemb; zmogljivost izračunajte brez prekoračitve. Pri size == 0 ali nmemb == 0 vrne nič brez spremembe polja ali toka. Po kratkem rezultatu uporabite feof in ferror; uporabite le popolne elemente, delni se ne šteje.
Primeri
#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;}
Rezultat
3 2 1 ABC DE
Primer shrani pet bajtov `ABCDE` in dvakrat zahteva tri. `3 2 1 ABC DE` pokaže popolno prvo branje, dva bajta pri drugem in nastavljen kazalnik konca.