CKTIS / C
fread — proudová funkce C23
`fread(ptr, size, nmemb, stream)` z `<stdio.h>` se pokusí načíst `nmemb` prvků po `size` bajtech do `ptr` a vrátí počet úplných prvků. Data jsou posloupnost `unsigned char`; krátký počet znamená konec nebo chybu.
Verze: C23
Syntaxe
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) z <stdio.h> se pokusí načíst nmemb prvků po size bajtech do ptr a vrátí počet úplných prvků. Data jsou posloupnost unsigned char; krátký počet znamená konec nebo chybu.
Příklad uloží pět bajtů ABCDE a dvakrát žádá tři. 3 2 1 ABC DE ukazuje úplné první čtení, dva bajty ve druhém a nastavený příznak konce.
Cíl musí pojmout size * nmemb; kapacitu počítejte bez přetečení. Při size == 0 nebo nmemb == 0 vrátí nulu beze změny pole a proudu. Po krátkém výsledku použijte feof a ferror; používejte jen úplné prvky, částečný se nepočítá.
Příklady
#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;}
Výsledek
3 2 1 ABC DE
Příklad uloží pět bajtů `ABCDE` a dvakrát žádá tři. `3 2 1 ABC DE` ukazuje úplné první čtení, dva bajty ve druhém a nastavený příznak konce.