fwrite
Écrit des données dans un flux.
size_t fwrite( const void *buffer, size_t size, size_t count, FILE *stream );
Paramètres
buffer
Pointeur vers des données à écrire.size
Taille de l'élément, en octets.count
Nombre maximal d'éléments à écrire.stream
Pointeur vers la structure FILE.
Valeur de retour
fwrite retourne le nombre d'éléments complets réellement écrits, qui peut être inférieur à count si une erreur se produit. De même, en cas d'erreur, il est impossible de déterminer l'indicateur de position de fichier. Si stream ou buffer est un pointeur null ou si un nombre impair d'octets à écrire est spécifié en mode Unicode, la fonction appelle le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction affecte à errno la valeur EINVAL et retourne 0.
Notes
La fonction fwrite écrit jusqu'aux éléments count, chacun d'une longueur size, de buffer vers la sortie stream. Le pointeur de fichier associé à stream (le cas échéant) est incrémenté du nombre d'octets réellement écrits. Si stream est ouvert en mode texte, chaque saut de ligne est remplacé par une paire retour chariot-saut de ligne. Le remplacement n'a aucun effet sur la valeur de retour.
Quand stream est ouvert en mode de traduction Unicode, par exemple, si stream est ouvert en appelant fopen et en utilisant un paramètre de mode qui inclut ccs=UNICODE, ccs=UTF-16LE ou ccs=UTF-8, ou si le mode est modifié pour un mode de traduction Unicode en utilisant _setmode et un paramètre de mode qui inclut _O_WTEXT, _O_U16TEXT ou _O_U8TEXT, buffer est interprété comme un pointeur vers un tableau de wchar_t qui contient des données UTF-16. Toute tentative d'écriture d'une quantité impaire d'octets dans ce mode provoque une erreur de validation de paramètre.
Comme cette fonction verrouille le thread appelant, il est thread-safe. Pour une version sans verrouillage, voir _fwrite_nolock.
Configuration requise
Fonction |
En-tête requis |
|---|---|
fwrite |
<stdio.h> |
Pour plus d'informations sur la compatibilité, voir Compatibilité.
Exemple
Voir l'exemple pour fread.