基本介紹
- 中文名：#ifndef
- 外文名：#ifndef(if not defined)
- 作用1：防止頭檔案的重複包含和編譯
- 作用2：便於程式的調試和移植
- 配套使用：#endif
- 類型：宏定義條件編譯
定義,作用,內容,作用,形式,
定義
#define x //定義一個宏
...
#endif
#ifndef x //先測試x是否被宏定義過
#define x
程式段1 //如果x沒有被宏定義過，定義x，並編譯程式段 1
#else
程式段2 //如果x已經定義過了則編譯程式段2的語句，“忽視”程式段 1
#endif//終止if
作用
條件指示符#ifndef的最主要目的是防止頭檔案的重複包含和編譯。條件編譯當然也可以用條件語句來實現， 但是用條件語句將會對整個源程式進行編譯，生成的目標代碼程式很長，而採用條件編譯，則根據條件只編譯其中的程式段1或程式段2，生成的目標程式較短。如果條件選擇的程式段很長，採用條件編譯的方法是十分必要的。
內容
#ifndef 標識1 //判斷"標識1"是否定義，如果被定義則返回假，如果沒有被定義則返回真。
/**********************************/
語句1 #ifndef 標識1
語句2 #define 標識1
語句3 #endif
語句4 ……
語句5 ……
該段代碼意思是：如果標識1沒有被定義，則重定義標識1，即執行語句2、語句3;如果標識1已經被定義，則直接跳過語句2、語句3，直接執行語句4、語句5、……
/***********************************/
備註：#ifndef 和 #endif 要一起使用，如果丟失#endif，可能會報錯。
需要注意的是，#ifndef起到的效果是防止一個源檔案兩次包含同一個頭檔案，而不是防止兩個源檔案包含同一個頭檔案。網上很多資料對這一細節的描述都是錯誤的。事實上，防止同一頭檔案被兩個不同的源檔案包含這種要求本身就是不合理的，頭檔案存在的價值就是被不同的源檔案包含。
假如你有一個C源檔案，它包含了多個頭檔案，比如頭檔案A和頭檔案B，而頭檔案B又包含了頭檔案A，則最終的效果是，該源檔案包含了兩次頭檔案A。如果你在頭檔案A里定義了結構體或者類類型（這是最常見的情況），那么問題來了，編譯時會報大量的重複定義錯誤。
例如要編寫頭檔案test.h，在頭檔案開頭寫上兩行：
#ifndef _TEST_H
#define _TEST_H //一般是檔案名稱的大寫
頭檔案結尾寫上一行：
#endif
這樣一個工程檔案里同時包含兩個test.h時，就不會出現重定義的錯誤了。
分析：
當第一次包含test.h時，由於沒有定義_TEST_H，條件為真，這樣就會包含（執行）#ifndef _TEST_H和#endif之間的代碼，當第二次包含test.h時前面一次已經定義了_TEST_H，條件為假，#ifndef _TEST_H和#endif之間的代碼也就不會再次被包含，這樣就避免了重定義了。
而把頭檔案的內容都放在#ifndef和#endif中，則無論頭檔案會不會被多個檔案引用，都需要加上這個。一般格式是這樣的：
#ifndef <標識>
#define <標識>
......
......
#endif
#ifndef _STDIO_H
#define _STDIO_H
......
#endif
作用
在c語言中，對同一個變數或者函式進行多次聲明是不會報錯的。所以如果h檔案里只是進行了聲明工作，即使不使用#ifndef宏定義，一個c檔案多次包含同一個h檔案也不會報錯。使用#ifndef可以避免下面這種錯誤：如果在h檔案中定義了全局變數，一個c檔案包含同一個h檔案多次，如果不加#ifndef宏定義，會出現變數重複定義的錯誤；如果加了#ifndef，則不會出現這種錯。
形式
“條件編譯”命令允許對程式中的內容選擇性地編譯，即可以根據一定的條件選擇是否編譯。
條件編譯的命令主要有以下幾種 ：
形式1
#ifndef 標識符
程式段 1
#else
程式段 2
#endif
它的作用是當“標識符”沒有由#define定義過時，則編譯“ 程式段1”，否則編譯“程式段2” ，其中如果不需要編譯“程式段2”。故上述形式可以變換為：
#ifndef 標識符
程式段 1
#endif
形式2
#ifndef 標識符
# define 標識符
程式段 1
#else
程式段 2
#endif
它的作用是當“標識符”沒有由# define定義過。 則編譯“程式段1”。否則編譯“程式段2” ；同樣當無“程式段2”時（作用與形式1完全相同），則上述形式變換為：
#ifndef 標識符
#define 標識符
程式段 1
#endif
形式3
