CKTIS / C
fwrite — fonction de flux C23
`fwrite(ptr, size, nmemb, stream)` de `<stdio.h>` écrit dans un flux jusqu’à `nmemb` objets de `size` octets depuis le tableau désigné par `ptr`. Chaque objet est traité comme des appels successifs à `fputc` sur sa représentation `unsigned char` ; le retour compte les objets entièrement écrits.
Version : C23
Syntaxe
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) de <stdio.h> écrit dans un flux jusqu’à nmemb objets de size octets depuis le tableau désigné par ptr. Chaque objet est traité comme des appels successifs à fputc sur sa représentation unsigned char ; le retour compte les objets entièrement écrits.
L’exemple écrit trois int avec fwrite(values, sizeof values[0], 3, stream), qui renvoie 3. Après retour au début, il les relit avec le même type et affiche 3 7 -2 42, montrant que le compte porte sur les éléments, non sur les octets.
Un résultat inférieur à nmemb signale une erreur d’écriture ; consultez aussi ferror, car des octets du dernier objet partiel peuvent déjà être présents. Si size ou nmemb vaut zéro, le retour vaut zéro et l’état du flux ne change pas. La source doit couvrir size * nmemb octets. Représentation brute, padding, boutisme et largeur des types empêchent d’en faire un format d’échange portable.
Exemples
#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;}
Résultat
3 7 -2 42
L’exemple écrit trois `int` avec `fwrite(values, sizeof values[0], 3, stream)`, qui renvoie `3`. Après retour au début, il les relit avec le même type et affiche `3 7 -2 42`, montrant que le compte porte sur les éléments, non sur les octets.