约 1975 字

约 10 分钟

#C 语言标准库函数 fwrite

/*********************************************
 * @brief 写文件
 * @param buffer 指向要写入的对象的指针
 * @param size 每个对象的大小
 * @param count 需要写入的对象数量
 * @param fp 文件流
 * @return 成功写入的对象个数
 ********************************************/
size_t fwrite(void* restrict buffer, size_t size, size_t count, FILE* restrict fp);

说明

将 buffer 指向内存中的 count 个 size 字节的对象写入文件流 fp。

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

参数

  • buffer - 指向存储对象空间的指针
  • size - 每个对象的大小(字节)
  • count - 要写入的对象数量
  • fp - 要写入的文件流

返回值

  • 返回成功写入的对象个数,可能小于 count

#示例

#include <stdio.h>

int main(void)
{
    // 打开文件
    FILE* fp = tmpfile();

    if (fp == NULL)
    {
        perror("文件打开失败");
        return 1;
    }

    char buffer[10] = "123456789\n";

    // 写文件
    printf("%zu\n", fwrite(buffer, 10, 1, fp));  // 以 10 个字节作为 1 个对象,写入 1 个对象
    printf("%zu\n", fwrite(buffer, 5, 2, fp));   // 以 5 个字节作为 1 个对象,写入 2 个对象
    printf("%zu\n", fwrite(buffer, 1, 10, fp));  // 以 1 个字节作为 1 个对象,写入 10 个对象

    // 关闭文件
    fclose(fp);

    return 0;
}

运行结果:

1
2
10

#推荐阅读

#参考标准

  • C23 standard (ISO/IEC 9899:2024):
    • 7.21.8.2 The fwrite function (p: TBD)
  • C17 standard (ISO/IEC 9899:2018):
    • 7.21.8.2 The fwrite function (p: TBD)
  • C11 standard (ISO/IEC 9899:2011):
    • 7.21.8.2 The fwrite function (p: 335-336)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.19.8.2 The fwrite function (p: 301-302)
  • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.9.8.2 The fwrite function

更新: 2025/10/25

作者: PlanC

创建: 2025/8/12