C / C++ / 系统课时

从文本文件读取已有数据

从文本文件读取已有数据

程序把数据写入文件后,下一步通常是把已有内容可靠地读回来。本课用 fopen、fgets 和 sscanf 读取一个简单文本文件,并重点处理循环终止、格式异常和文件打开失败,避免把 feof 当成“下一次读取一定成功”的判断条件。

学习目标

  • 使用只读模式打开文本文件,并在结束后正确关闭文件。
  • 用 fgets 逐行读取,再用 sscanf 解析结构化字段。
  • 正确判断文件结束、读取错误和单行格式错误。

准备一个可读取的文本文件

假设当前目录已有 scores.txt,每行保存“姓名 分数”两个字段:

text
Alice 92
Bob 85
Carol 78

这个文件只是输入数据,不要求程序修改它。文本格式简单时,可以直接按格式读取;但教学和实际排错中,先读取整行,再解析字段通常更稳妥,因为你能区分“读不到下一行”和“这一行格式不对”这两类问题。

用 fgets 驱动读取循环

下面的程序以只读模式打开文件,并让 fgets 的返回值直接决定循环是否继续。只要成功读到一行,fgets 就返回传入的缓冲区地址;遇到文件末尾或读取错误时返回 NULL。

c
#include <stdio.h>

int main(void) {
    FILE *file = fopen("scores.txt", "r");
    if (file == NULL) {
        perror("fopen");
        return 1;
    }

    char line[128];
    char name[32];
    int score;
    int line_number = 0;

    while (fgets(line, sizeof line, file) != NULL) {
        line_number++;

        /* 限制字符串宽度,避免姓名字段写出 name 缓冲区。 */
        if (sscanf(line, "%31s %d", name, &score) == 2) {
            printf("%s -> %d\n", name, score);
        } else {
            fprintf(stderr, "invalid line %d: %s", line_number, line);
        }
    }

    /* 循环结束后再区分正常 EOF 与真正的读取错误。 */
    if (ferror(file)) {
        perror("read");
        fclose(file);
        return 1;
    }

    fclose(file);
    return 0;
}

预期输出(scores.txt 内容与上文一致):

text
Alice -> 92
Bob -> 85
Carol -> 78

这里 sscanf 返回成功匹配并赋值的字段数量。期望姓名和分数都读取成功,因此必须等于 2;如果某行只有姓名、分数不是整数或格式被破坏,该行会进入错误分支,而不会把旧值误当成新数据。

编译并验证

在 reader.c 与 scores.txt 位于同一目录时执行:

bash
gcc -Wall -Wextra -std=c11 reader.c -o reader && ./reader

预期输出:

text
Alice -> 92
Bob -> 85
Carol -> 78

如果程序输出 fopen: No such file or directory,先确认运行程序时的当前工作目录,而不是只看源码文件所在位置。相对路径 scores.txt 是相对于进程当前工作目录解析的。

不要用 feof 作为读取条件

常见错误是先检查 feof(file),再尝试读取。下面是错误的片段示例,依赖已经打开的 FILE *file 上下文:

c
while (!feof(file)) {
    /* 错误思路:此时只能知道“上一次读取后是否已经设置 EOF 标志”。 */
}

feof 不会提前预测下一次读取是否越过文件末尾;EOF 标志通常是在一次读取尝试失败后才被设置。因此,循环条件应该检查读取函数本身是否成功,例如 fgets(...) != NULL 或 fscanf(...) == 期望字段数。

读取结束后要区分 EOF 和错误

fgets 返回 NULL 有两种主要原因:正常到达文件末尾,或底层读取发生错误。循环结束后使用 ferror(file) 可以判断是否属于后者;正常 EOF 不需要当成故障。

文件读取的核心顺序可以记成:打开文件 → 以读取函数返回值驱动循环 → 解析当前数据 → 循环后检查错误 → 关闭文件。这样既不会多处理一轮,也能把格式错误、EOF 和 I/O 错误分开处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

从文本文件读取已有数据

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

登录哪都通