CKTIS / C
fwrite — funkcija toka C23
`fwrite(ptr, size, nmemb, stream)` iz `<stdio.h>` v tok zapiše do `nmemb` objektov po `size` bajtov iz polja, ki ga označuje `ptr`. Vsak objekt obdela kot zaporedne klice `fputc` nad njegovo predstavitvijo `unsigned char`; vrnjena vrednost šteje v celoti zapisane objekte.
Različica: C23
Sintaksa
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) iz <stdio.h> v tok zapiše do nmemb objektov po size bajtov iz polja, ki ga označuje ptr. Vsak objekt obdela kot zaporedne klice fputc nad njegovo predstavitvijo unsigned char; vrnjena vrednost šteje v celoti zapisane objekte.
Primer z fwrite(values, sizeof values[0], 3, stream) zapiše tri vrednosti int in dobi 3. Po vrnitvi na začetek jih prebere z istim tipom ter izpiše 3 7 -2 42; števec meri elemente, ne bajtov.
Rezultat manjši od nmemb pomeni napako pisanja; preverite tudi ferror, saj so bajti delnega zadnjega objekta morda že zapisani. Če je size ali nmemb nič, vrne nič in stanje toka ostane enako. Vir mora obsegati size * nmemb bajtov. Surove predstavitve lahko vsebujejo padding ter so odvisne od endian in širin tipov, zato niso prenosljiv izmenjevalni format.
Primeri
#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;}
Rezultat
3 7 -2 42
Primer z `fwrite(values, sizeof values[0], 3, stream)` zapiše tri vrednosti `int` in dobi `3`. Po vrnitvi na začetek jih prebere z istim tipom ter izpiše `3 7 -2 42`; števec meri elemente, ne bajtov.