前處理器

 

C

編譯器支援

語言

標頭檔

型別支援

程式公用程式

可變引數函式支援

錯誤處理

動態記憶體管理

字串函式庫

演算法

數值

日期與時間公用程式

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規格

符號索引

 

C 語言

基本概念

關鍵字

前處理器

語句

運算式

初始化

宣告

函式

其他

C 語言歷史

技術規格

 

前處理器

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C23)(C23)

#define#undef#,## 運算子

#include__has_include (C23)

#error#warning (C23)

#pragma_Pragma (C99)

#line

#embed__has_embed (C23)(C23)

 

預處理器在轉譯階段 4執行，於編譯之前。預處理的結果是一個單一的檔案，接著會被傳遞給實際的編譯器。

指令

預處理指令控制預處理器的行為。每個指令佔用一行，並具有以下格式：

• # 字元
• 預處理指示（define, undef, include, if, ifdef, ifndef, else, elif, elifdef, elifndef(C23 起), endif, line, embed(C23 起), error, warning(C23 起), pragma 之一）
• 參數（取決於該指令）
• 換行符號。

允許使用空指令（# 後接換行符號），它不會產生任何效果。

功能

預處理器具有以下原始碼檔案轉譯功能：

• 條件式編譯原始碼檔案的部分內容（由指令 #if, #ifdef, #ifndef, #else, #elif, #elifdef, #elifndef(C23 起) 以及 #endif 控制）。
• 替換文字巨集，同時可能進行識別字串接或引號處理（由指令 #define 和 #undef，以及運算子 # 和 ## 控制）。
• 包含其他檔案（由指令 #include，並可透過 __has_include 檢查(C23 起) 控制）。
• 觸發錯誤或警告(C23 起)（分別由指令 #error 或 #warning(C23 起) 控制）。

以下預處理器面向可被控制：

• 實作定義的行為（由指令 #pragma 和運算子 _Pragma(C99 起) 控制）。
• 供預處理器使用的檔名與行號資訊（由指令 #line 控制）。

參考資料

• C23 標準 (ISO/IEC 9899:2024)

• 6.10 預處理指令 (p: 待定)

• C17 標準 (ISO/IEC 9899:2018)

• 6.10 預處理指令 (p: 117-129)

• C11 標準 (ISO/IEC 9899:2011)

• 6.10 預處理指令 (p: 160-178)

• C99 標準 (ISO/IEC 9899:1999)

• 6.10 預處理指令 (p: 145-162)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 3.8 預處理指令

參見

C 文件：預定義巨集符號

C 文件：巨集符號索引

C++ 文件：預處理器