CKTIS / C
fwrite — prúdová funkcia C23
`fwrite(ptr, size, nmemb, stream)` z `<stdio.h>` zapíše do prúdu až `nmemb` objektov po `size` bajtoch z poľa označeného `ptr`. Každý objekt spracuje ako následné volania `fputc` nad jeho reprezentáciou `unsigned char`; návratová hodnota počíta celé zapísané objekty.
Verzia: C23
Syntax
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) z <stdio.h> zapíše do prúdu až nmemb objektov po size bajtoch z poľa označeného ptr. Každý objekt spracuje ako následné volania fputc nad jeho reprezentáciou unsigned char; návratová hodnota počíta celé zapísané objekty.
Príklad zapíše tri hodnoty int pomocou fwrite(values, sizeof values[0], 3, stream), ktoré vráti 3. Po návrate na začiatok ich načíta rovnakým typom a vytlačí 3 7 -2 42; počet je v prvkoch, nie bajtoch.
Výsledok menší než nmemb znamená chybu zápisu; skontrolujte aj ferror, pretože bajty čiastočného posledného objektu už môžu byť zapísané. Ak je size či nmemb nula, vráti nulu a stav prúdu sa nezmení. Zdroj musí pokrývať size * nmemb bajtov. Surová reprezentácia môže mať padding a závisieť od endianity i šírok typov, takže nie je prenosným formátom.
Príklady
#include <stdio.h>
int main(void){int values[3]={7,-2,42},copy[3]={0};FILE *stream=tmpfile();if(!stream)return 1;size_t written=fwrite(values,sizeof values[0],3,stream);rewind(stream);if(fread(copy,sizeof copy[0],3,stream)!=3){fclose(stream);return 1;}printf("%zu %d %d %d\n",written,copy[0],copy[1],copy[2]);return fclose(stream)==0?0:1;}
Výsledok
3 7 -2 42
Príklad zapíše tri hodnoty `int` pomocou `fwrite(values, sizeof values[0], 3, stream)`, ktoré vráti `3`. Po návrate na začiatok ich načíta rovnakým typom a vytlačí `3 7 -2 42`; počet je v prvkoch, nie bajtoch.