fread

Считывает до count объектов в массив buffer из заданного входного потока stream , как если бы вызывался fgetc size раз для каждого объекта, и сохраняет результаты, в полученном порядке, в последовательные позиции buffer , который переинтерпретируется как массив unsigned char . Индикатор позиции файла для потока продвигается на количество прочитанных символов.

Если возникает ошибка, результирующее значение индикатора позиции файла для потока становится неопределенным. Если частичный элемент считывается, его значение является неопределенным.

Параметры

Возвращаемое значение

Количество успешно прочитанных объектов, которое может быть меньше, чем count при возникновении ошибки или условия конца файла.

Если size или count равны нулю, fread возвращает ноль и не выполняет других действий.

fread не различает конец файла и ошибку, и вызывающая сторона должна использовать feof и ferror чтобы определить, что произошло.

Пример

#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

Ссылки

Смотрите также