fread
在头文件<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函数
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
