在头文件<stdio.h>中定义​​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): 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函数