/*********************************************
* @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);
!subtitle:说明
将 buffer 指向内存中的 count 个 size 字节的对象写入文件流 fp。
fwrite 不区分文件结束和错误,调用者需要使用 feof 和 ferror 进行判断。
!subtitle:参数
buffer - 指向存储对象空间的指针
size - 每个对象的大小(字节)
count - 要写入的对象数量
fp - 要写入的文件流
!subtitle:返回值
返回成功写入的对象个数,可能小于 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