一句话理解 fscanf

「按照‘采矿图纸’（格式字符串），从文件‘矿脉’中精准提取数据，存入指定变量！」

函数原型

#include 
int fscanf(FILE *stream, const char *format, ...);  // "..." 是可变参数（必须是变量地址）

入口参数

参数	类型	比喻解释
stream	FILE*	要挖掘的「矿脉」（文件指针）
format	const char*	「采矿图纸」（含占位符的格式字符串）
...	指针类型	存放矿石的「集装箱地址」（变量地址）

返回参数

返回值	含义
int	成功提取的数据项数
EOF	矿脉枯竭（文件结束）或采矿设备故障

核心功能图解

文件内容：25 3.14 Hello
调用 fscanf(file, "%d%f%s", &a, &b, name)
→ 成功提取3项数据：a=25, b=3.14, name="Hello"

代码实例：采矿实战

场景1：提取结构化数据（学生档案）

#include 

typedef struct {
    char name[20];
    int age;
    float score;
} Student;

int main() {
    FILE *file = fopen("students.txt", "r");
    if (!file) {
        perror(" 矿脉勘探失败");
        return 1;
    }

    Student s;
    // 按格式提取数据：姓名（无空格） 年龄 分数
    while (fscanf(file, "%19s %d %f", s.name, &s.age, &s.score) == 3) {
        printf("学生：%-10s | 年龄：%2d | 分数：%5.2f\n", 
               s.name, s.age, s.score);
    }

    fclose(file);
    return 0;
}

输入文件（students.txt）：

Alice 20 95.5
Bob 19 88.0
Charlie 21 76.5

场景2：处理复杂格式（CSV解析）

#include 

int main() {
    FILE *csv = fopen("data.csv", "r");
    if (!csv) return 1;

    int id;
    char product[20];
    float price;
    int stock;

    // 跳过CSV标题行
    fscanf(csv, "%*[^\n]\n");  // "%*"表示读取但不保存

    // 提取格式：ID,产品名,价格,库存
    while (fscanf(csv, "%d,%19[^,],%f,%d", &id, product, &price, &stock) == 4) {
        printf("ID:%04d | 商品：%-10s | 售价：%6.2f | 库存：%3d\n", 
               id, product, price, stock);
    }

    fclose(csv);
    return 0;
}

输入文件（data.csv）：

ID,Product,Price,Stock
101,Apple,5.50,200
202,Keyboard,299.00,50
303,Monitor,1599.99,30

采矿事故（常见错误）

1.图纸与矿脉不匹配

// 文件内容：3.14
float f;
fscanf(file, "%d", &f);  //  用整数图纸挖浮点矿石 → 数据错乱

2.集装箱容量不足

char buf[5];
fscanf(file, "%s", buf);  // 输入"HelloWorld" →  缓冲区溢出
// 安全写法：fscanf(file, "%4s", buf);  //  最多挖4字符+自动补\0

3.矿脉未勘探（文件未打开）

FILE *file = NULL;
fscanf(file, "%d", &num);  //  采矿机未启动 → 程序崩溃

安全采矿指南（错误处理模板）

FILE *file = fopen("data.txt", "r");
if (!file) { /* 处理文件打开失败 */ }

int a, b;
while (1) {
    int result = fscanf(file, "%d %d", &a, &b);
    if (result == EOF) {
        printf("矿脉已枯竭\n");
        break;
    } else if (result == 2) {
        printf("成功挖掘：%d 和 %d\n", a, b);
    } else {
        printf(" 发现杂质！跳过损坏区域\n");
        // 清空错误输入直到换行符
        while (fgetc(file) != '\n' && !feof(file));
    }
}
fclose(file);

技术细节剖析

1.与 scanf 的兄弟关系

scanf("%d", &num);     // 从键盘（stdin）采矿
fscanf(file, "%d", &num);  // 从文件采矿

2.高级采矿技巧

跳过特定字符：

// 文件内容：Value=42 
fscanf(file, "Value=%d", &num); // 提取42

读取指定字符集：

// 只读取小写字母 
fscanf(file, "%[a-z]", str);

3.返回值隐藏的密码

返回值	含义分析
= 预期项数	完美采矿
< 预期项数	矿脉不纯/格式不匹配
EOF	矿脉枯竭或设备故障

采矿图纸速查表（常用占位符）

占位符	用途	示例
%d	十进制整数	fscanf(file, "%d", &num)
%f	float浮点数	fscanf(file, "%f", &f)
%lf	double浮点数	fscanf(file, "%lf", &d)
%s	字符串（无空格）	fscanf(file, "%9s", buf)
%c	字符（包括空格）	fscanf(file, " %c", &c)（注意空格）
%[]	自定义字符集合	fscanf(file, "%[^,]", str)（读取到逗号前）

总结

核心功能：按格式从文件中提取数据
必用场景：配置文件解析、日志分析、数据转换
安全准则：

永远检查返回值！
字符串必须限制长度（如 %19s）
优先用 fgets + sscanf 处理复杂格式

类比记忆：就像矿工用图纸在矿脉中定位稀有矿石，fscanf 是程序员从文件中精准提取数据的「数据采矿机」