C 语言中文开发手册
]
fread (File input/output) - C 中文开发手册
| 在头文件<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('
');
} else { // error handling
if (feof(fp))
printf("Error reading test.bin: unexpected end of file
");
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函数
C 语言中文开发手册