/*********************************************
* @brief 读取文件
* @param[out] buffer 指向存储对象空间的指针
* @param size 每个对象的大小
* @param count 需要读取的对象数量
* @param fp 文件流
* @return 成功读取的对象个数
********************************************/
size_t fread(void* restrict buffer, size_t size, size_t count, FILE* restrict fp);
!subtitle:说明
从文件流 fp 中读取 count 个 size 字节的对象,保存到 buffer 指向的内存中。
fread 不区分文件结束和错误,调用者需要使用 feof 和 ferror 进行判断。
!subtitle:参数
buffer - 指向存储对象空间的指针
size - 每个对象的大小(字节)
count - 要读取的对象数量
fp - 要读取的文件流
!subtitle:返回值
返回成功读取的对象个数,可能小于 count
#include <stdio.h>
int main(void)
{
// 打开文件
FILE* fp = fopen("/dev/random", "rb"); // "/dev/random" 是 Linux 系统上的随机数生成器设备
if (fp == NULL)
{
perror("文件打开失败");
return 1;
}
char buffer[10];
// 读取文件
printf("%zu\n", fread(buffer, 10, 1, fp)); // 以 10 个字节作为 1 个对象,读取 1 个对象
printf("%zu\n", fread(buffer, 5, 2, fp)); // 以 5 个字节作为 1 个对象,读取 2 个对象
printf("%zu\n", fread(buffer, 1, 10, fp)); // 以 1 个字节作为 1 个对象,读取 10 个对象
// 关闭文件
fclose(fp);
return 0;
}
运行结果:
1
2
10
C23 standard (ISO/IEC 9899:2024):
7.21.8.1 The fread function (p: TBD)
C17 standard (ISO/IEC 9899:2018):
7.21.8.1 The fread function (p: 243-244)
C11 standard (ISO/IEC 9899:2011):
7.21.8.1 The fread function (p: 335)
C99 standard (ISO/IEC 9899:1999):
7.19.8.1 The fread function (p: 301)
C89/C90 standard (ISO/IEC 9899:1990):
4.9.8.1 The fread function