fread

在头文件中定义
size_t fread（void * buffer，size_t size，size_t count，FILE * stream）;		（直到C99）
size_t fread（void * restrict buffer，size_t size，size_t count，FILE * restrict stream）;		（自C99以来）

从给定的输入流中读取count对象到数组中buffer，stream就像调用fgetc size每个对象的时间一样，并将结果按获得的顺序存储到连续的位置buffer，并重新解释为数组unsigned char。流的文件位置指示符按读取的字符数进行提前。

如果发生错误，则流的文件位置指示符的结果值不确定。如果读取了部分元素，则其值是不确定的。

参数

缓冲	-	指向存储读取对象的数组的指针
尺寸	-	每个对象的大小以字节为单位
计数	-	要读取的对象的数量
流	-	要读取的流

返回值

成功读取的对象数量，可能少于count发生错误或文件结束条件时的数量。

如果size或者count为零，则fread返回零且不执行其他操作。

fread不区分文件结束和错误，呼叫者必须使用feof并ferror确定发生的事件。

例

#include <stdio.h>
 
enum { SIZE = 5 };
int main(void)
{
    double a[SIZE] = {1.,2.,3.,4.,5.};
    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"
    size_t ret_code = fread(b, sizeof *b, SIZE, fp // reads an array of doubles
    if(ret_code == SIZE) {
        puts("Array read successfully, contents: "
        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 read successfully, contents: 
1.000000 2.000000 3.000000 4.000000 5.000000

参考

C11标准（ISO / IEC 9899：2011）：