fread

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

size_t fread( void* restrict buffer, size_t size, size_t count,
              FILE* restrict stream );

Lee hasta count objetos en el arreglo buffer desde el flujo de entrada dado stream como si llamara a fgetc size veces por cada objeto, y almacena los resultados, en el orden obtenido, en las posiciones sucesivas de buffer, que se reinterpreta como un arreglo de unsigned char. El indicador de posición del archivo para el flujo avanza según la cantidad de caracteres leídos.

Si ocurre un error, el valor resultante del indicador de posición del archivo para el flujo es indeterminado. Si se lee un elemento parcial, su valor es indeterminado.

Parámetros

Valor de retorno

Número de objetos leídos exitosamente, que puede ser menor que count si ocurre un error o una condición de fin de archivo.

Si size o count es cero, fread devuelve cero y no realiza ninguna otra acción.

fread no distingue entre fin de archivo y error, y los llamadores deben usar feof y ferror para determinar cuál ocurrió.

Ejemplo

#include <stdio.h>

enum { SIZE = 5 };

int main(void)
{
    const double a[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0};
    printf("Array has size %ld bytes, element size: %ld\n", sizeof a, sizeof* a);
    FILE* fp = fopen("test.bin", "wb"); // must use binary mode
    fwrite(a, sizeof* a, SIZE, fp); // writes an array of doubles
    fclose(fp);

    double b[SIZE];
    fp = fopen("test.bin","rb");
    const size_t ret_code = fread(b, sizeof b[0], SIZE, fp); // reads an array of doubles
    if (ret_code == SIZE)
    {
        printf("Array at %p read successfully, contents:\n", (void*)&a);
        for (int n = 0; n != SIZE; ++n)
            printf("%f ", b[n]);
        putchar('\n');
    }
    else // error handling
    {
        if (feof(fp))
            printf("Error reading test.bin: unexpected end of file\n");
        else if (ferror(fp))
            perror("Error reading test.bin");
    }

    fclose(fp);
}

Array has size 40 bytes, element size: 8
Array at 0x1337f00d6960 read successfully, contents:
1.000000 2.000000 3.000000 4.000000 5.000000

Referencias

Véase también