CKTIS / C
fread — funkcija toka C23
`fread(ptr, size, nmemb, stream)` iz `<stdio.h>` pokušava čitati `nmemb` elemenata od `size` bajtova u `ptr` i vraća broj potpunih elemenata. Podaci su slijed `unsigned char`; kratak broj znači kraj ili pogrešku.
Verzija: 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> pokušava čitati nmemb elemenata od size bajtova u ptr i vraća broj potpunih elemenata. Podaci su slijed unsigned char; kratak broj znači kraj ili pogrešku.
Primjer sprema pet bajtova ABCDE i dvaput traži tri. 3 2 1 ABC DE pokazuje potpuno prvo čitanje, dva bajta pri drugom i postavljen pokazatelj kraja.
Odredište mora primiti size * nmemb; računaj bez preljeva. Ako je size == 0 ili nmemb == 0, vraća nulu bez promjene polja ili toka. Nakon kratkog rezultata koristi feof i ferror; koristi samo potpune elemente jer se djelomični ne broji.
Primjeri
#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
Primjer sprema pet bajtova `ABCDE` i dvaput traži tri. `3 2 1 ABC DE` pokazuje potpuno prvo čitanje, dva bajta pri drugom i postavljen pokazatelj kraja.