fwrite

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

É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 .

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 le paramètre 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ètre non valide, 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.

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.

FonctionEn-tête requis
fwrite<stdio.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

Consultez l’exemple de fread.

System::IO::FileStream::Write

Flux d’e/s
_setmode
fread
_fwrite_nolock
_write

Afficher: