Subrutina fwrite o fwrite

Finalidad

Lee y graba archivos binarios.

Biblioteca

Biblioteca C estándar (libc.a)

Sintaxis

#include <stdio.h>
size_t fread (Pointer, Size, NumberOfItems, Stream)
void *Pointer;
size_tSize, NumberOfItems;
FILE *Stream;
size_t fwrite (Pointer, Size, NumberOfItems, Stream)
const void *Pointer;
size_t Size, NumberOfItems;
FILE *Stream;

Descripción

La subrutina fread copia el número de elementos de datos especificados por el parámetro NumberOfItems del flujo de entrada en una matriz que comienza en la ubicación apuntada por el parámetro Pointer. Cada elemento de datos tiene el formato *Puntero.

La subrutina fread deja de copiar bytes si se encuentra una condición de fin de archivo (EOF) o de error mientras se lee de la entrada especificada por el parámetro Stream, o cuando se ha copiado el número de elementos de datos especificado por el parámetro NumberOfItems. Esta subrutina deja el puntero de archivo del parámetro Corriente , si se ha definido, apuntando al byte que sigue al último byte leído. La subrutina fread no cambia el contenido del parámetro Corriente .

Los 2st_atimese marcará para la actualización por la primera ejecución satisfactoria de la subrutina fgetc, fgets, fgetwc, fgetws, fread, fscanf, getc, getchar, Obtencioneso scanf utilizando una corriente que devuelve datos no suministrados por una llamada anterior a la subrutina ungetco ungetwc .

La subrutina fwrite graba elementos de la matriz a los que apunta el parámetro Puntero a la corriente a la que apunta el parámetro Corriente . El parámetro Tamaño especifica el tamaño de cada elemento. La subrutina fwrite escribe el número de elementos especificado por el parámetro NumberOfItems. El indicador de posición de archivo para la corriente se ha avanzado por el número de bytes grabados satisfactoriamente. Si se produce un error, el valor resultante del indicador de posición de archivo para la corriente es indeterminado.

La subrutina fwrite añade elementos a la corriente de salida de la matriz a la que apunta el parámetro Puntero . La subrutina fwrite añade tantos elementos como se especifique en el parámetro NumberOfItems.

La subrutina fwrite detiene la escritura de bytes si se encuentra una condición de error en el flujo, o cuando se ha escrito el número de elementos de datos especificado por el parámetro NumberOfItems. La subrutina fwrite no cambia el contenido de la matriz a la que apunta el parámetro Puntero .

Los 2st_ctimeyst_mtimeLos campos se marcarán para la actualización entre la ejecución satisfactoria de la subrutina fwrite y la siguiente finalización de una llamada a la subrutina fflush o fclose en la misma corriente, la siguiente llamada a la subrutina Salida o la siguiente llamada a la subrutina abortar .

Parámetros

Valores de retorno

Las subrutinas fread y fwrite devuelven el número de elementos realmente transferidos. Si el parámetro NumberOfItems contiene un 0, no se transfiere ningún carácter y se devuelve el valor 0. Si el parámetro NumberOfItems contiene un número negativo, se convierte a un número positivo, ya que el parámetro NumberOfItems es de tipo unsigned.

Códigos de error

Si la subrutina fread no es satisfactoria porque la corriente de E/S no tiene almacenamiento intermedio o es necesario leer los datos en el almacenamiento intermedio de la corriente de E/S, devuelve uno o más de los siguientes códigos de error:

Si la subrutina fwrite no es satisfactoria porque la corriente de E/S no está en el almacenamiento intermedio o el almacenamiento intermedio de la corriente de E/S debe vaciarse, devuelve uno o más de los siguientes códigos de error:

La subrutina fwrite tampoco se ha realizado correctamente debido a las siguientes condiciones de error: