fwrite

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Escribe datos en un flujo.

size_t fwrite(  
   const void *buffer,  
   size_t size,  
   size_t count,  
   FILE *stream   
);  

Parámetros

buffer
Puntero a los datos que se van a escribir.

size
Tamaño del elemento en bytes.

count
Número máximo de elementos que se va a escribir.

stream
Puntero a la estructura FILE .

fwrite devuelve el número de elementos completos escritos realmente, que puede ser menor que count si se produce un error. De igual modo, si se produce un error, no se podrá conocer el indicador de posición de archivo. Si el valor stream o buffer es un puntero nulo, o si se especifica un número impar de bytes que se escribirán en el modo Unicode, la función invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, esta función establece errno en EINVAL y devuelve 0.

La función fwrite escribe un máximo de count elementos (con una longitud de size cada uno) desde el buffer al stream de salida. El puntero de archivo asociado a stream (si lo hay) se incrementa según el número de bytes escritos realmente. Si el stream se abre en modo de texto, cada salto de línea se reemplazará por un par de retorno de carro-avance de línea. Este reemplazo no tiene efecto alguno en el valor devuelto.

Cuando stream se abre en un modo de conversión Unicode (por ejemplo, si stream se abre llamando a fopen y usando un parámetro de modo que incluye ccs=UNICODE, ccs=UTF-16LE o ccs=UTF-8, o si el modo se cambia a un modo de conversión Unicode mediante _setmode y un parámetro de modo que incluye _O_WTEXT, _O_U16TEXT o _O_U8TEXT), el buffer se interpretará como un puntero a una matriz de wchar_t que contiene datos UTF-16. Si se intenta escribir un número impar de bytes en este modo, se producirá un error de validación de parámetros.

Como esta función bloquea el subproceso de llamada, es segura para los subprocesos. Para consultar una versión que no realiza el bloqueo, vea _fwrite_nolock.

FunciónEncabezado necesario
fwrite<stdio.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

Vea el ejemplo de fread.

System::IO::FileStream::Write

E/S de secuencia
_setmode
fread
_fwrite_nolock
_write

Mostrar: