預處理器

 

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++ 文件 中的 預處理器