C語言預處理指令詳解：#error、#line、#undef

引言

預處理指令在編譯前對源碼進行文本級處理。除常見的 #define、#include、條件編譯外，#error、#line、#undef 是進階開發中強大的工具，分別用於編譯期斷言、行號/文件名控制、宏取消定義。

一、#error — 編譯期強制報錯

語法

#error token-string

• token-string 為任意字符序列，將作為錯誤信息輸出。
• 不進行宏展開。
• 編譯器輸出錯誤後立即終止編譯。

典型用途

• 強制要求特定編譯環境（如必須用 C++ 編譯器）。
• 檢測配置矛盾（如互斥宏同時被定義）。

示例

#if !defined(__cplusplus)
#error C++ compiler required.
#endif

二、#line — 控制編譯器行號與文件名

語法

#line digit-sequence ["filename"]

• digit-sequence：任意整數常量，設置 __LINE__ 預定義宏。
• filename：可選，雙引號包圍，設置 __FILE__ 預定義宏。
• 宏替換可作用於預處理標記，但結果必須符合語法。

應用場景

• 代碼生成器：讓生成代碼的錯誤定位指向原始源文件而非生成文件。
• 自訂斷言宏：結合 __LINE__、__FILE__ 輸出精確錯誤位置。

示例

// 設置當前行號為 151，文件名為 copy.c
#line 151 "copy.c"

// 自定義斷言宏
#define ASSERT(cond) if(!(cond)) \
    {printf("assertion error line %d, file(%s)\n", __LINE__, __FILE__);}

三、#undef — 取消宏定義

語法

#undef identifier

• 移除 identifier 的當前宏定義，後續出現將被預處理器忽略。
• 對未定義的標識符也可使用，確保其處於未定義狀態。
• 語句內不進行宏替換。

常見模式

1. 局部宏隔離：配對 #define/#undef 限制宏作用域，避免污染全局命名空間。
2. 條件編譯控制：搭配 #if 實現精細的編譯開關。
3. 命令行取消：MSVC 支持 /U macro-name 相當於文件開頭的 #undef。

示例

#define WIDTH 80
#define ADD(X, Y) ((X) + (Y))
... 使用宏 ...
#undef WIDTH
#undef ADD
// 此處後 WIDTH、ADD 已不可用

總結

善用這三條指令，能顯著提升代碼的健壯性、可維護性與診斷能力。