国际访客建议访问 Primers 编程伙伴 国际版站点 > C 教程 > fread 以获得更好的体验。

# C 语言标准库函数 fread

在头文件 stdio.h 中定义。
/*********************************************
 * @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 中读取 countsize 字节的对象,保存到 buffer 指向的内存中。

fread 不区分文件结束和错误,调用者需要使用 feofferror 进行判断。

!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

本文 更新于: 2025-11-27 09:38:08 创建于: 2025-11-27 09:38:08