C語言scanf格式字符串陷阱：多餘%號導致輸入阻塞分析

C語言scanf格式字符串陷阱：多餘%號導致輸入阻塞分析

「c語言中輸入任意兩個數，求和、差、積？運行輸入三個數才能出來結果」——這是典型的 `scanf` 格式字符串錯誤導致的輸入匹配失敗。本文深度解析 `scanf` 返回值機制、格式字符串解析規則、輸入緩衝區殘留、最佳實踐與調試技巧。

一、錯誤代碼現場還原

// 錯誤代碼
int main() {
    int a, b, c, d, e;
    scanf("%d%d%", &a, &b);  // ❌ 關鍵錯誤：格式字符串末尾多出 "%"
    c = a + b;
    d = a - b;
    e = a * b;
    printf("和=%d\n差=%d\n積=%d", c, d, e);
    system("pause");
    return 0;
}

二、為什麼需要輸入三個數？

scanf("%d%d%", &a, &b) 解析過程：

1. 讀取格式字符串："%d" "%d" "%"
2. 第一個 %d：匹配輸入流中的整數 → 賦值給 a，成功，返回值計數+1
3. 第二個 %d：匹配輸入流中的整數 → 賦值給 b，成功，返回值計數+1
4. 第三個 "%"：這是一個 **字面字符匹配指令**！
   - 它要求輸入流中下一個字符必須是 '%' 符號
   - 如果不是 '%'，匹配失敗，scanf 立即返回，不再處理後續格式
   - 由於用戶輸入的是數字和空格/換行，沒有 '%'，匹配失敗

現象：
- 用戶輸入: "10 20\n"
- scanf 匹配 10 → a=10
- scanf 匹配 20 → b=20
- scanf 期望下一個字符是 '%'，但讀到 '\n' (換行)
- 匹配失敗，scanf 返回 2 (成功賦值的項數)
- 但關鍵在於：輸入流中的 '\n' 仍然殘留！
- 程序繼續執行 printf 輸出結果
- 然後 system("pause") 等待

為什麼說「輸入三個數才能出來結果」？
- 可能用戶輸入: "10 20 %\n" (第三個輸入了 % 字符)
- 或者用戶輸入: "10 20 30\n"，以為需要三個數
- 實際上 scanf 在第三個格式 "%" 處卡住，直到輸入 % 或 EOF

三、scanf 核心機制：返回值與輸入流狀態

四、正確代碼與最佳實踐

// 正確版本
int main() {
    int a, b;
    int sum, diff, prod;
    
    printf("請輸入兩個整數 (空格或換行分隔): ");
    
    // 1. 檢查返回值：必須等於期望賦值項數
    if (scanf("%d %d", &a, &b) != 2) {
        fprintf(stderr, "輸入錯誤：請輸入兩個整數\n");
        // 清理輸入緩衝區 (可選)
        int c;
        while ((c = getchar()) != '\n' && c != EOF);
        return 1;
    }
    
    sum = a + b;
    diff = a - b;
    prod = a * b;
    
    printf("和 = %d\n差 = %d\n積 = %d\n", sum, diff, prod);
    return 0;
}

五、scanf 格式字符串解析規則完全指南

格式字符串由三類組成：
1. 空白字符 (空格、\t、\n 等)
   - 作用：跳過輸入流中任意數量 (含0) 的空白字符
   - "%d %d" 和 "%d%d" 效果相同 (因為 %d 自帶跳過前導空白)
   - 但 "%c" 不跳過空白，需用 " %c" (前導空格) 跳過

2. 普通字符 (非 %、非空白)
   - 作用：精確匹配輸入流中對應字符
   - 失敗則停止掃描，該字符留在輸入流
   - 例：scanf("%d%%", &x) 要求輸入 "100%"

3. 轉換說明 (以 % 開頭)
   - 格式：%[*][寬度][長度]類型
   - *: 抑制賦值 (只匹配不存儲) 如 %*d 跳過一個整數
   - 寬度: 最大讀取字符數 如 %10s 讀最多10字符
   - 長度: hh/h/l/ll/j/z/t/L 對應類型大小
   - 類型: d/i/u/o/x/X/f/e/g/a/c/s/p/n/[%[...]]

六、常見 scanf 陷阱與修正

七、現代替代方案：fgets + strto* / sscanf

// 更安全、更可控的輸入模式
int read_int(const char *prompt, int *out) {
    char buf[256];
    printf("%s", prompt);
    if (!fgets(buf, sizeof(buf), stdin)) return 0; // EOF
    
    char *endptr;
    long val = strtol(buf, &endptr, 10);
    if (endptr == buf || (*endptr != '\n' && *endptr != '\0')) {
        return 0; // 非純整數
    }
    *out = (int)val;
    return 1;
}

// 或使用 sscanf 解析已讀取的行
int parse_two_ints(const char *line, int *a, int *b) {
    char *endptr;
    long v1 = strtol(line, &endptr, 10);
    if (endptr == line) return 0;
    long v2 = strtol(endptr, &endptr, 10);
    if (endptr == line) return 0;
    *a = (int)v1; *b = (int)v2;
    return 1;
}

八、調試技巧：看見不可見的輸入流

// 1. 打印 scanf 返回值
int ret = scanf("%d%d", &a, &b);
printf("DEBUG: scanf returned %d, a=%d, b=%d\n", ret, a, b);

// 2. 查看輸入緩衝區殘留
int c;
printf("DEBUG: buffer residual: '");
while ((c = getchar()) != '\n' && c != EOF) putchar(c);
printf("'\n");

// 3. 使用 hexdump 查看原始輸入
// echo "10 20" | xxd
// 00000000: 3130 2032 300a                    10 20.

// 4. 編譯器警告 (GCC/Clang)
-gcc -Wformat -Wformat-security -Wformat=2
// 會警告: format '%d%' expects argument of type 'int *', but argument 3 has type 'int *'
// 以及: too many arguments for format

核心教訓：scanf 格式字符串每個字符都有含義，% 不是裝飾品。務必檢查返回值，理解輸入流殘留機制，關鍵路徑改用 fgets+strto* 組合。這樣就能徹底告別「為什麼要輸入三個數」的困惑。