CKTIS / C
fwrite — funkcija toka C23
`fwrite(ptr, size, nmemb, stream)` iz `<stdio.h>` u tok piše do `nmemb` objekata od po `size` bajtova iz polja koje označava `ptr`. Svaki objekt obrađuje kao uzastopne pozive `fputc` nad njegovim prikazom `unsigned char`; povrat broji potpuno zapisane objekte.
Verzija: 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> u tok piše do nmemb objekata od po size bajtova iz polja koje označava ptr. Svaki objekt obrađuje kao uzastopne pozive fputc nad njegovim prikazom unsigned char; povrat broji potpuno zapisane objekte.
Primjer s fwrite(values, sizeof values[0], 3, stream) piše tri vrijednosti int i dobiva 3. Nakon povratka na početak čita ih istim tipom te ispisuje 3 7 -2 42; broje se elementi, ne bajtovi.
Rezultat manji od nmemb znači pogrešku pisanja; provjeri i ferror, jer bajtovi djelomičnog zadnjeg objekta možda su već zapisani. Ako je size ili nmemb nula, vraća nulu i stanje toka ostaje isto. Izvor mora obuhvatiti size * nmemb bajtova. Sirovi prikazi mogu sadržavati padding i ovisiti o endianu i širinama tipova, pa nisu prenosiv format razmjene.
Primjeri
#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
Primjer s `fwrite(values, sizeof values[0], 3, stream)` piše tri vrijednosti `int` i dobiva `3`. Nakon povratka na početak čita ih istim tipom te ispisuje `3 7 -2 42`; broje se elementi, ne bajtovi.