CKTIS / C
fwrite — C23-Datenstromfunktion
`fwrite(ptr, size, nmemb, stream)` aus `<stdio.h>` schreibt bis zu `nmemb` Objekte mit je `size` Bytes aus dem von `ptr` bezeichneten Array in einen Strom. Jedes Objekt wird wie aufeinanderfolgende `fputc`-Aufrufe seiner `unsigned char`-Darstellung verarbeitet; Rückgabe ist die Zahl vollständig geschriebener Objekte.
Version: C23
Syntax
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) aus <stdio.h> schreibt bis zu nmemb Objekte mit je size Bytes aus dem von ptr bezeichneten Array in einen Strom. Jedes Objekt wird wie aufeinanderfolgende fputc-Aufrufe seiner unsigned char-Darstellung verarbeitet; Rückgabe ist die Zahl vollständig geschriebener Objekte.
Das Beispiel schreibt drei int-Werte mit fwrite(values, sizeof values[0], 3, stream) und erhält 3. Nach dem Zurücksetzen liest es sie als denselben Typ und druckt 3 7 -2 42; gezählt werden Elemente, nicht Bytes.
Ein Ergebnis kleiner als nmemb bedeutet Schreibfehler; auch ferror prüfen, da Bytes eines unvollständigen letzten Objekts bereits geschrieben sein können. Ist size oder nmemb null, sind Ergebnis und Zustandsänderung null. Die Quelle muss size * nmemb Bytes umfassen. Rohe Objektdarstellungen können Padding enthalten und von Bytefolge sowie Typbreiten abhängen; sie sind kein portables Austauschformat.
Beispiele
#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;}
Ergebnis
3 7 -2 42
Das Beispiel schreibt drei `int`-Werte mit `fwrite(values, sizeof values[0], 3, stream)` und erhält `3`. Nach dem Zurücksetzen liest es sie als denselben Typ und druckt `3 7 -2 42`; gezählt werden Elemente, nicht Bytes.