C語言的條件編譯#if, #elif, #else, #endif、#ifdef, #ifndef

十日十乞001發表於2017-06-26

有些程式在除錯、相容性、平臺移植等情況下可能想要通過簡單地設定一些引數就生成一個不同的軟體,這當然可以通過變數設定,把所有可能用到的程式碼都寫進去,在初始化時配置,但在不同的情況下可能只用到一部分程式碼,就沒必要把所有的程式碼都寫進去,就可以用條件編譯,通過預編譯指令設定編譯條件,在不同的需要時編譯不同的程式碼。

   (一)條件編譯方法

   條件編譯是通過預編譯指令來實現的,主要方法有:

   1、#if, #elif, #else, #endif

 #if 條件 1
 程式碼段 1
#elif 條件 2
   程式碼段 2
...
#elif 條件 n
 程式碼段 n
#else
 程式碼段 n+1
#endif

  即可以設定不同的條件,在編譯時編譯不同的程式碼,預編譯指令中的表示式與C語言本身的表示式基本一至如邏輯運算、算術運算、位運算等均可以在預編譯指令中使用。之所以能夠實現條件編譯是因為預編譯指令是在編譯之前進行處理的,通過預編譯進行巨集替換、條件選擇程式碼段,然後生成最後的待編譯程式碼,最後進行編譯。

   #if的一般含義是,如果#if後面的常量表示式為true,則編譯它所控制的程式碼,如條件1成立時就程式碼段1,條件1不成立再看條件2是否成立,如果條件2成立則編譯程式碼段2,否則再依次類推判斷其它條件,如果條件1-N都不成力則會編譯最後的程式碼段n+1.

   2、#ifdef, #else, #endif或#ifndef, #else, #endif

  條件編譯的另一種方法是用#ifdef與#ifndef命令,它們分別表示“如果有定義”及“如果無定義”。有定義是指在編譯此段程式碼時是否有某個巨集通過 #define 指令定義的巨集,#ifndef指令指找不到通過#define定義的某巨集,該巨集可以是在當前檔案此條指令的關面定義的,也可以是在其它檔案中,但在此指令之前包含到該檔案中的。

#ifdef的一般形式是:

 #ifdef macro_name
    程式碼段 1
#else
    程式碼段 2
#endif


#ifdef的一般形式是:

#ifndef macro_name
    程式碼段 2
#else
    程式碼段 1
#endif

   這兩段程式碼的效果是完全一樣的。

   3、通過巨集函式defined(macro_name)

  引數為巨集名(無需加""),如果該macro_name定義過則返回真,否則返回假,用該函式則可以寫比較複雜的條件編譯指令如

 #if defined(macro1) || (!defined(macro2) && defined(macro3))
...
#else
...
#endif

   (二)條件編譯技巧與示例

   (1)#ifdef和#defined()比較

  首先比較一下這兩種方法,第一種方法只能判斷一個巨集,如果條件比較複雜實現起來比較煩鎖,用後者就比較方便。如有兩個巨集MACRO_1,MACRO_2只有兩個巨集都定義過才會編譯程式碼段A,分別實現如下:

 #ifdef MACRO_1
#ifdef MACRO_2
    程式碼段 A
#endif
#endif

或者
#if defined(MACRO_1) && defined(MACRO_2)
#endif

  同樣,要實現更復雜的條件用#ifdef更麻煩,所以推薦使用後者,因為即使當前程式碼用的是簡單的條件編譯,以後在維護、升級時可能會增加,用後者可維護性較強。舊的編譯器可能沒有實現#defined()指令,C99已經加為標準。要相容老的編譯器,還需用#ifdef指令。

   2、#if與 #ifdef或#if defined()比較

   比如自己寫了一個printf函式,想通過一個巨集MY_PRINTF_EN實現條件編譯,用#if可實現如下

C語言的條件編譯。#define MY_PRINTF_EN 1
#if MYS_PRINTF_EN == 1
 int printf(char* fmt, char* args, ...)
{
    ...
}
#endif

  如果巨集MY_PRINTF_EN定義為1則編譯這段程式碼,如果巨集定義不為1或者沒有定義該巨集,則不編譯這段程式碼。同樣也可以通過#ifdef或者#defined()實現,如

 #define MY_PRINTF_EN 1

#if defined(MY_PRINTF_EN)
 int printf(char* fmt, char* args, ...)
{
    ...
}
#endif

  在這種情況下兩種方法具有異曲同工之妙,但試想如果你為了節約程式碼寫了兩個printf函式,在不同情況下使用不同的printf函式,一個是精簡版一個是全功能標準版,如:

 #define MY_PRINTF_SIMPLE

#ifdef MY_PRINTF_SIMPLE
   void printf(*str) // 向終端簡單地輸出一個字串
{...
}
#endif
#ifdef MY_PRINTF_STANDARD
 int printf(char* fmt, char* args, ...)
{...
}
#endif

同樣可以用#if defined()實現
#define MY_PRINTF_SIMPLE

#if defined(MY_PRINTF_SIMPLE)
   void printf(*str) // 向終端簡單地輸出一個字串
{
    ...
}
#elif defined(MY_PRINTF_STANDARD)
 int printf(char* fmt, char* args, ...)
{
    ...
}
#endif

  兩種方法都可以實現,但可見後者更方便。但試想如果你有三個版本,用前者就更麻煩了,但方法相似,用後者就更方便,但仍需三個巨集進行控制,你要住三個巨集,改進一下就用#if可以用一個巨集直接控制N種情況如:

 #define MY_PRINTF_VERSION     1

#if MY_PRINTF_VERSION == 1
   void printf(*str) // 向終端簡單地輸出一個字串
{
    ...
}
#elif MY_PRINTF_VERSION == 2
 int printf(char* fmt, char* args, ...)
{
    ...
}
#elif MY_PRINTF_VERSION == 3
int printf(unsigned char com_number, char* str)
{
    ...
}
#else
    預設版本
#endif

   這樣,你只需修改一下數字就可以完成版本的選擇了

   看來好像用#if 比較好了,試想如下情況:你寫了一個配置檔案叫做config.h用來配置一些巨集,通過這些巨集來控制程式碼,如你在config.h的巨集

   #define MY_PRINTF_EN 1

   來控制是否需要編譯自己的printf函式,而在你的原始碼檔案printf.c中有如下指令

 #i nclude "config.h"
#if MY_PRINTF_EN == 1
 int printf(char* fmt, char* args, ...)
{
    ...
}
#endif

  但這樣也會有一個問題,就是如果你忘了在config.h中新增巨集MY_PRINTF_EN,那麼自己寫的printf函式也不會被編譯,有些編譯器會給出警告:MY_PRINTF_EN未定義。如果你有兩個版本的想有一個預設版本,可以在printf.c中這樣實現

 #incldue "config.h"
#if !defined(MY_PRINTF_VERSION)
  #define MY_PRINTF_VERSION   1
#endif

#if MY_PRINTF_VERSION == 1
   void printf(*str) // 向終端簡單地輸出一個字串
{
    ...
}
#elif MY_PRINTF_VERSION == 2
 int printf(char* fmt, char* args, ...)
{
    ...
}
#elif MY_PRINTF_VERSION == 3
int printf(unsigned char com_number, char* str)
{
    ...
}
#endif

 這種情況下還得用到#ifdef或#if defined(),你可以不用動主體的任何程式碼,只需要修改printf.c檔案中MY_RPINTF_VERSION巨集的數字就可以改變了,如果用前面那種方法還得拖動程式碼,在拖動中就有可能造成錯誤。

   再試想,如果軟體升級了,或者有了大的改動,原來有三個版本,現在只剩下兩個版本了,如

 #if MY_PRINTF_VERSION == 2
 int printf(char* fmt, char* args, ...)
{
    ...
}
#elif MY_PRINTF_VERSION == 3
int printf(unsigned char com_number, char* str)
{
    ...
}
#endif

  因為這些核心程式碼不想讓使用這些程式碼的人關心,他們只需要修改config.h檔案,那就要在printf.c中實現相容性。如果以前有人在config.h配置巨集MY_PRINTF_VERSION為1,即有

   #define MY_PRINTF_VERSION   1

   而現在沒有1版本了,要想相容怎麼辦?那當然可以用更復雜的條件實現如:

 #if MY_PRINTF_VERSION == 2 || MY_PRINTF_VERSION == 1
 int printf(char* fmt, char* args, ...)
{
    ...
}
#elif MY_PRINTF_VERSION == 3
int printf(unsigned char com_number, char* str)
{
    ...
}
#endif

   不過還有另外一種方法,即使用#undef命令

 #if MY_PRINTF_VERSION == 1
  #undef MY_PRINTF_VERSION
  #define MY_PRINTF_VERSION  2
#endif
#if MY_PRINTF_VERSION == 2
 int printf(char* fmt, char* args, ...)
{
    ...
}
#elif MY_PRINTF_VERSION == 3
int printf(unsigned char com_number, char* str)
{
    ...
}
#endif

 

   用#if還有一個好處,如果你把巨集名記錯了,把MY_PRINTF_EN定義成了MY_PRINT_EN,那麼你用#ifdef MY_PRINTF_EN或者#if defined(MY_PRINTF_EN)控制的程式碼就不能被編譯,查起來又不好查,用#if MY_PRINTF_EN ==1控制就很好查,因為你把MY_PRINTF_EN定義成MY_PRINT_EN,則MY_PRINTF_EN實際上沒有定義,那麼編譯器會給出警告#if MY_PRINTF_EN == 1中的MY_PRINTF_EN沒有定義,但錯就比較快。


相關文章