Daily-C-Study(16)：C语言条件编译#ifdef
成于坚持，败于止步
在讲define预处理指令的时候，忘记去说明预处理指令在c语言中到底担当的是什么样的角色，这里花点时间说一下：
预处理过程扫描源代码，对其进行初步的转换，产生新的源代码提供给编译器。可见预处理过程先于编译器对源代码进行处理。
在C语言中，并没有任何内在的机制来完成如下一些功能：在编译时包含其他源文件、定义宏、根据条件决定编译时是否包含某些代码。要完成这些工作，就需要使用预处理程序。尽管在目前绝大多数编译器都包含了预处理程序，但通常认为它们是独立于编译器的。预处理过程读入源代码，检查包含预处理指令的语句和宏定义，并对源代码进行响应的转换。预处理过程还会删除程序中的注释和多余的空白字符。
预处理指令是以#号开头的代码行。#号必须是该行除了任何空白字符外的第一个字符。#后是指令关键字，在关键字和#号之间允许存在任意个数的空白字符。整行语句构成了一条预处理指令，该指令将在编译器进行编译之前对源代码做某些转换。
#空指令，无任何效果
#include包含一个源代码文件
#define定义宏
#undef取消已定义的宏
#if如果给定条件为真，则编译下面代码
#ifdef如果宏已经定义，则编译下面代码
#ifndef如果宏没有定义，则编译下面代码
#elif如果前面的#if给定条件不为真，当前条件为真，则编译下面代码
#endif结束一个#if……#else条件编译块
#error停止编译并显示错误信息
#line改变当前行数和文件名称，很少用
#pragma设定编译器的状态或者是指示编译器完成一些特定的动作
#pragma warning(disable:4507 34) // 不显示4507和34号警告信息，我只曾经这样用过
ok，现在继续说我们的条件编译指令，条件编译的功能使得我们可以按不同的条件去编译不同的程序部分，因而产生不同的目标代码文件。这对于程序的移植和调试是很有用的。
条件编译有三种形式，下面分别介绍：
第一种形式：
#ifdef 标识符
程序段1
#else
程序段2
#endif
程序段1
#else
程序段2
#endif
它的功能是，如果标识符已被#define 命令定义过则对程序段1 进行编译；否则对程序段2进行编译。如果没有程序段2(它为空)，本格式中的#else 可以没有，即可以写为：
#ifdef 标识符
程序段
#endif
第二种形式：
#ifndef 标识符
程序段1
#else
程序段2
#endif
与第一种形式的区别是将“ifdef”改为“ifndef”。它的功能是，如果标识符未被#define 命令定义过则对程序段1 进行编译，否则对程序段2 进行编译。这与第一种形式的功能正相反。
第三种形式：
#if 常量表达式
程序段1
#else
程序段2
#endif
它的功能是，如常量表达式的值为真(非0)，则对程序段1 进行编译，否则对程序段2 进行编译。因此可以使程序在不同条件下，完成不同的功能。至于#elif 命令意义与else if 相同，它形成一个if else-if 阶梯状语句，可进行多种编译选择。
条件编译技巧与示例
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可实现如下
#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没有定义，但错就比较快。
就先到这里，O(∩_∩)O~
我的专栏地址：http://blog.csdn.net/column/details/c-daily-study.html
待续。。。。。。
作者：Ela–学海无涯
来源：CSDN
原文：https://blog.csdn.net/xinyuwuxian/article/details/9033095
版权声明：本文为博主原创文章，转载请附上博文链接！