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)
{
    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）：
  • 7.21.8.1 fread函数（p：335）
• C99标准（ISO / IEC 9899：1999）：
  • 7.19.8.1 fread函数（p：301）
• C89 / C90标准（ISO / IEC 9899：1990）：
  • 4.9.8.1 fread函数