Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

fwrite — función de flujo de C23

`fwrite(ptr, size, nmemb, stream)` de `<stdio.h>` escribe en un flujo hasta `nmemb` objetos de `size` bytes desde el array señalado por `ptr`. Cada objeto se procesa como llamadas sucesivas a `fputc` sobre su representación `unsigned char`; devuelve el número de objetos completos escritos.

Versión: C23

Sintaxis

size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);

fwrite(ptr, size, nmemb, stream) de <stdio.h> escribe en un flujo hasta nmemb objetos de size bytes desde el array señalado por ptr. Cada objeto se procesa como llamadas sucesivas a fputc sobre su representación unsigned char; devuelve el número de objetos completos escritos.

El ejemplo escribe tres int mediante fwrite(values, sizeof values[0], 3, stream), que devuelve 3. Tras volver al inicio los lee con el mismo tipo y muestra 3 7 -2 42, demostrando que el recuento es de elementos y no de bytes.

Un resultado menor que nmemb significa error de escritura; consulta también ferror, pues pueden haberse escrito bytes de un último objeto parcial. Si size o nmemb es cero, devuelve cero y el estado del flujo no cambia. La fuente debe cubrir size * nmemb bytes. Las representaciones crudas pueden tener padding y depender de endianness y anchos de tipo, por lo que no son formato de intercambio portable.

Ejemplos

#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;}

Resultado

3 7 -2 42

El ejemplo escribe tres `int` mediante `fwrite(values, sizeof values[0], 3, stream)`, que devuelve `3`. Tras volver al inicio los lee con el mismo tipo y muestra `3 7 -2 42`, demostrando que el recuento es de elementos y no de bytes.

Fuentes