fread
来自 zh.cppreference.net
| 定义于头文件 <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。流的文件位置指示器按读取的字符数前进。
如果发生错误，流的文件位置指示器的结果值是不确定的。如果读取了部分元素，其值是不确定的。
参数
| buffer | - | 指向存储读取对象的数组的指针 |
| size | - | 每个对象的大小（以字节为单位） |
| count | - | 要读取的对象数量 |
| stream | - | 要读取的流 |
返回值
成功读取的对象数量，可能小于 count 如果发生错误或遇到文件结束条件。
如果 size 或 count 为零，则 fread 返回零并且不执行其他操作。
fread 不区分文件结束和错误，调用者必须使用 feof 和 ferror 来确定发生了哪种情况。
示例
运行此代码
#include <stdio.h>
enum { SIZE = 5 };
int main(void)
{
const double a[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0};
printf("Array has size %ld bytes, element size: %ld\n", sizeof a, sizeof* a);
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");
const size_t ret_code = fread(b, sizeof b[0], SIZE, fp); // reads an array of doubles
if (ret_code == SIZE)
{
printf("Array at %p read successfully, contents:\n", (void*)&a);
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 has size 40 bytes, element size: 8
Array at 0x1337f00d6960 read successfully, contents:
1.000000 2.000000 3.000000 4.000000 5.000000
参考
- C23标准（ISO/IEC 9899:2024）：
- 7.21.8.1 fread函数（页码：待定）
- C17标准（ISO/IEC 9899:2018）：
- 7.21.8.1 fread函数（页码：243-244）
- C11标准（ISO/IEC 9899:2011）：
- 7.21.8.1 fread函数（页码：335）
- C99标准（ISO/IEC 9899:1999）：
- 7.19.8.1 fread函数（页码：301）
- C89/C90标准（ISO/IEC 9899:1990）：
- 4.9.8.1 fread函数
另见
(C11)(C11)(C11) |
从stdin、文件流或缓冲区读取格式化输入 （函数） |
| 从文件流获取字符串 （函数） | |
| 写入文件 （函数） | |
C++ 文档 的 fread
| |