C / C++ / 系统课时
从文本文件读取已有数据
从文本文件读取已有数据
程序把数据写入文件后,下一步通常是把已有内容可靠地读回来。本课用 fopen、fgets 和 sscanf 读取一个简单文本文件,并重点处理循环终止、格式异常和文件打开失败,避免把 feof 当成“下一次读取一定成功”的判断条件。
学习目标
- 使用只读模式打开文本文件,并在结束后正确关闭文件。
- 用
fgets逐行读取,再用sscanf解析结构化字段。 - 正确判断文件结束、读取错误和单行格式错误。
准备一个可读取的文本文件
假设当前目录已有 scores.txt,每行保存“姓名 分数”两个字段:
Alice 92
Bob 85
Carol 78这个文件只是输入数据,不要求程序修改它。文本格式简单时,可以直接按格式读取;但教学和实际排错中,先读取整行,再解析字段通常更稳妥,因为你能区分“读不到下一行”和“这一行格式不对”这两类问题。
用 fgets 驱动读取循环
下面的程序以只读模式打开文件,并让 fgets 的返回值直接决定循环是否继续。只要成功读到一行,fgets 就返回传入的缓冲区地址;遇到文件末尾或读取错误时返回 NULL。
#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 内容与上文一致):
Alice -> 92
Bob -> 85
Carol -> 78这里 sscanf 返回成功匹配并赋值的字段数量。期望姓名和分数都读取成功,因此必须等于 2;如果某行只有姓名、分数不是整数或格式被破坏,该行会进入错误分支,而不会把旧值误当成新数据。
编译并验证
在 reader.c 与 scores.txt 位于同一目录时执行:
gcc -Wall -Wextra -std=c11 reader.c -o reader && ./reader预期输出:
Alice -> 92
Bob -> 85
Carol -> 78如果程序输出 fopen: No such file or directory,先确认运行程序时的当前工作目录,而不是只看源码文件所在位置。相对路径 scores.txt 是相对于进程当前工作目录解析的。
不要用 feof 作为读取条件
常见错误是先检查 feof(file),再尝试读取。下面是错误的片段示例,依赖已经打开的 FILE *file 上下文:
while (!feof(file)) {
/* 错误思路:此时只能知道“上一次读取后是否已经设置 EOF 标志”。 */
}feof 不会提前预测下一次读取是否越过文件末尾;EOF 标志通常是在一次读取尝试失败后才被设置。因此,循环条件应该检查读取函数本身是否成功,例如 fgets(...) != NULL 或 fscanf(...) == 期望字段数。
读取结束后要区分 EOF 和错误
fgets 返回 NULL 有两种主要原因:正常到达文件末尾,或底层读取发生错误。循环结束后使用 ferror(file) 可以判断是否属于后者;正常 EOF 不需要当成故障。
文件读取的核心顺序可以记成:打开文件 → 以读取函数返回值驱动循环 → 解析当前数据 → 循环后检查错误 → 关闭文件。这样既不会多处理一轮,也能把格式错误、EOF 和 I/O 错误分开处理。