C / C++ / 系统课时
把程序数据写入文本文件
把程序数据写入文本文件
程序中的结构化数据只有写入文件后才能跨进程、跨运行保留下来。本课用 fprintf 把一组学生成绩按固定文本格式写入 scores.txt,同时处理文件打开失败、写入失败和关闭失败,形成一条可验证的文本文件输出流程。
学习目标
- 会用
fprintf把整数、字符串和浮点数按指定格式写入文本文件 - 会检查
fopen、fprintf和fclose的失败结果 - 能为后续读取设计稳定、简单、可检查的文本格式
先确定文件里的文本格式
fprintf 与 printf 的格式控制方式几乎相同,只是第一个参数是目标 FILE *。例如 %d 写整数、%s 写字符串、%.2f 把浮点数保留两位小数。
为了让文件既方便人查看,也容易以后用程序解析,本例使用简单的逗号分隔格式,并先写一行表头:
id,name,score
1,Alice,91.50
2,Bob,84.00
3,Carol,95.25这不是完整的 CSV 解析方案;如果字段中可能包含逗号、引号或换行,就需要额外的转义规则。本课先聚焦 fprintf 的写入过程。
用 fprintf 写入一组结构化数据
下面的程序定义一个 Student 结构体数组,以 w 模式创建 scores.txt,依次写入表头和每条记录。任何一次写入失败都会停止处理,并返回非零状态。
#include <stdio.h>
typedef struct {
int id;
const char *name;
double score;
} Student;
int main(void) {
const Student students[] = {
{1, "Alice", 91.5},
{2, "Bob", 84.0},
{3, "Carol", 95.25}
};
const size_t count = sizeof(students) / sizeof(students[0]);
FILE *file = fopen("scores.txt", "w");
if (file == NULL) {
perror("fopen");
return 1;
}
if (fprintf(file, "id,name,score\n") < 0) {
perror("fprintf");
fclose(file);
return 1;
}
for (size_t i = 0; i < count; ++i) {
if (fprintf(file, "%d,%s,%.2f\n",
students[i].id,
students[i].name,
students[i].score) < 0) {
perror("fprintf");
fclose(file);
return 1;
}
}
if (fclose(file) != 0) {
perror("fclose");
return 1;
}
printf("已写入 %zu 条记录到 scores.txt\n", count);
return 0;
}预期结果
终端输出:
已写入 3 条记录到 scores.txt
scores.txt 内容:
id,name,score
1,Alice,91.50
2,Bob,84.00
3,Carol,95.25这里使用 %.2f,所以 84.0 会写成 84.00。fprintf 成功时返回写出的字符数,失败时返回负值,因此检查 < 0 就能发现格式化写入错误。
为什么不能只检查 fopen
fopen 成功只表示文件流已经建立,不代表后续所有写入都会成功。磁盘空间耗尽、设备错误或底层 I/O 失败,都可能发生在真正写数据的时候。
代码在每次 fprintf 后检查返回值,并在结束时检查 fclose。这是因为标准 I/O 通常带缓冲,部分数据可能直到刷新或关闭阶段才真正交给操作系统。若只看 fopen,就可能把“文件能打开”误认为“数据已经可靠写完”。
覆盖写还是追加写
本例使用 w,每次运行都会重新生成 scores.txt,适合“导出当前完整数据”。如果目标是不断追加日志或新记录,可以改用 a,已有内容会保留,新内容追加到末尾。
不过追加结构化记录时要注意表头:如果每次都用 a 并再次写入 id,name,score,文件中会出现重复表头。实际程序通常先判断文件是否为空,或把“创建新文件”和“追加已有文件”分成不同逻辑。
当文本格式简单、数据量不大且需要人工查看时,fprintf 很实用;如果数据包含复杂转义、嵌套结构或强事务要求,就应考虑成熟的 CSV/JSON 库或数据库,而不是继续手写分隔规则。