C / C++ / 系统课时

把程序数据写入文本文件

把程序数据写入文本文件

程序中的结构化数据只有写入文件后才能跨进程、跨运行保留下来。本课用 fprintf 把一组学生成绩按固定文本格式写入 scores.txt,同时处理文件打开失败、写入失败和关闭失败,形成一条可验证的文本文件输出流程。

学习目标

  • 会用 fprintf 把整数、字符串和浮点数按指定格式写入文本文件
  • 会检查 fopen、fprintf 和 fclose 的失败结果
  • 能为后续读取设计稳定、简单、可检查的文本格式

先确定文件里的文本格式

fprintf 与 printf 的格式控制方式几乎相同,只是第一个参数是目标 FILE *。例如 %d 写整数、%s 写字符串、%.2f 把浮点数保留两位小数。

为了让文件既方便人查看,也容易以后用程序解析,本例使用简单的逗号分隔格式,并先写一行表头:

text
id,name,score
1,Alice,91.50
2,Bob,84.00
3,Carol,95.25

这不是完整的 CSV 解析方案;如果字段中可能包含逗号、引号或换行,就需要额外的转义规则。本课先聚焦 fprintf 的写入过程。

用 fprintf 写入一组结构化数据

下面的程序定义一个 Student 结构体数组,以 w 模式创建 scores.txt,依次写入表头和每条记录。任何一次写入失败都会停止处理,并返回非零状态。

c
#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;
}

预期结果

text
终端输出:
已写入 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 库或数据库,而不是继续手写分隔规则。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把程序数据写入文本文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通