CKTIS / C
fwrite — C23-streamfunctie
`fwrite(ptr, size, nmemb, stream)` uit `<stdio.h>` schrijft maximaal `nmemb` objecten van `size` bytes uit de door `ptr` aangewezen array naar een stream. Elk object wordt verwerkt als opeenvolgende `fputc`-aanroepen over zijn `unsigned char`-weergave; de retour telt volledig geschreven objecten.
Versie: C23
Syntax
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) uit <stdio.h> schrijft maximaal nmemb objecten van size bytes uit de door ptr aangewezen array naar een stream. Elk object wordt verwerkt als opeenvolgende fputc-aanroepen over zijn unsigned char-weergave; de retour telt volledig geschreven objecten.
Het voorbeeld schrijft drie int-waarden met fwrite(values, sizeof values[0], 3, stream), wat 3 retourneert. Na terugspoelen leest het hetzelfde type en print 3 7 -2 42; de telling betreft elementen, niet bytes.
Een resultaat kleiner dan nmemb betekent een schrijffout; controleer ook ferror, want bytes van een gedeeltelijk laatste object kunnen al geschreven zijn. Als size of nmemb nul is, is het resultaat nul en blijft de streamtoestand gelijk. De bron moet size * nmemb bytes omvatten. Ruwe objectweergaven kunnen padding bevatten en van bytevolgorde en typebreedte afhangen, dus zijn geen overdraagbaar uitwisselingsformaat.
Voorbeelden
#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;}
Resultaat
3 7 -2 42
Het voorbeeld schrijft drie `int`-waarden met `fwrite(values, sizeof values[0], 3, stream)`, wat `3` retourneert. Na terugspoelen leest het hetzelfde type en print `3 7 -2 42`; de telling betreft elementen, niet bytes.