标准C预处理器
时间：2010-05-13 来源：_kevin_lee
标准C预处理器
该文章借鉴一位老兄的文章，主要是取自PROGRAMMING IN ANSI c(Third Edition).
什么是预处理器？
答：预处理器是一个iechengxu，在源代码通过编译器之前，它先对源代码进行处理。它是在成为预处理器命令行或指令的控制下操作。预处理器指令放在源程序的main函数之前。在源代码通过编译器之前，由预处理器检查所有预处理指令。如果有预处理器指令，则采取相应的动作，然后再把源程序交给编译器。
常用的预处理器指令集及其功能：
指令 作用
#define 定义一个宏替换
#undef 取消一个宏定义
#include 指定要包含的文件
#ifdef 测试某个宏已定义
#endif 表示#if的结束
#ifndef 测试某个宏未定义
#if 测试一个编译时条件
#else 当#if测试失败时，指定另一个测试
这些指令可以分为三类：
（1）、宏替换指令
（2）、文件包含指令
（3）、编译器控制指令
以下分别介绍：
一、宏替换指令
宏替换是程序中的标识符被预定义的字符串（由一个或者多个标记符组成）取代的过程。预处理器在#define指令下完成这一工作。为宏定义中的表达式使用括号是明智之举。
指令最常见的有三种：
1、简单宏替换
#define PI 3.1415926
#define TITLE_HEIGTH 15
#define EAR_MODE 0
#define LOCAL_MODE 1
#define STR_NOPIM "Please check the PIM card."
#define START main(){
#define END }
#define BLANK_LINE printf("\n")
#define D (66 + 88)
2、含参数的宏
含参数的替换成为宏调用（类似于函数调用）。当调用宏时，预处理器将替换该字符串，即用实参替换形参。字符串就像一个模板。
#define CUBE(x) ((x)*(x)*(x))
#define MAX(a,b) (((a)>(b))?(a):(b))
#define ABS(x) (((x)>0)?(x):(-(x)))
#define at_o_msg2(x) at_o_msg(x, x_strlen(x))
#define _RGB2GRAY(r,g,b) ((((r) * 3) + ((g) * 6)+ ((b) * 1)) / 10)
#define swap(a,b) do { a ^= b; b ^= a; a ^= b; } while (0)
3、宏嵌套
一种是：在一个宏的的定义中使用另一个宏。预处理器将扩展每个#define宏，知道文本中不再有宏为止。另一种是一个宏用作另一个宏的参数。如该段最后两个例子用嵌套调用来得出x，y和z三者的最大值。
#define M 6
#define N M + 1
#define SQUARE(x) ((x)*(x))
#define CUBE(x) (SQUARE(x)*(x))
#define SIXTH(x) (CUBE(x)*SQUARE(x))
#define MAX(a,b) (((a)>(b))?(a):(b))
#define MAXEX(x,y,z) MAX(x,MAX(y,z))
二、文件包含指令
两种形式：
#include "filename"
其中，filename为含有所需宏定义或函数的文件名。此时，预处理器把filename的整个内容插到程序的源代码之中。当filename包含在双引号中时，首先从当前目录中查找该文件，然后再到标准目录中查找。
#include <filename>
在这种情况下，只在标准目录中查找该文件。
也允许被包含文件的嵌套，也就是说，一个被包含的文件又可以包含其他文件，
但是，文件不能包含自身。如果没有找到被包含的文件，将报告一个错误，且编译终止。
以下是一个.c文件的头文件：
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "_define.h"
#include "tc35605.h"
#include "port.h"
#include "diag.h"
#include "rfboottest.h"
#include "sysinfo.h"
#include "bios2os.h"
#include "cal.h"
Main()
{
……………
}
三、编译器控制指令
当开发一个大型程序时，我们可能要面临以下一种或者多种情况。
（1）、已包含的一个文件中含有某些宏定义，但不知道某个宏（假设TEST）是否定义在
该头文件中。而我们想确认一下TEST是否已经定义。
（2）、假设某个客户有两台不同类型的计算机，要求你编写一个可用在这两个系统上运行
的程序。尽管针对每个系统的某些代码会不同，但仍想使用同一个程序。
（3）、如果正在开发一个程序（假设用于销售分析），在公开市场上销售。某些客户可能
坚持应有某些附加特性。而我们想用一个程序来满足两种客户的需求。
（4）、假设正在测试我们的系统，这是一个规模较大的系统。我们可能希望在某些地方
插入printf语句，用于显示中间结果和消息，以便跟踪运行流程和错误（如果有）。这里语句称为调试语句。我们可能想让这些语句成为程序的一部分，但只有当我们需要是才起作用。
这些问题的一种解决办法是开发不同程序来不同情形的需求。另一种方法就是开发单个的全面的程序，它包含所有的可选代码，然后指定编译器跳过不需要的源代码。C 预处理器提供了一种称为条件编译的特性，它可用来关闭或打开程序的某一行或多行。
以下分别针对上面四种情况举例说明：
1、情形1
次情形指的是宏的条件定义。假设不管TEST宏是否已经在头文件中定义了，我们都想确保
宏总是已经定义的。可以如下来实现，其中DEFINE.H为含有TEST宏定义的头文件。
#define "DEFINE.H"
#ifndef TEST
#define TEST 1
#endif
....
语句 #ifndef在DEFINE.H文件中查找TEST的定义，如果没有定义，那么#ifndef与相应的
#endif指令之间的代码将被执行。如果已经定义，相应的代码将被忽略。
同样，不想让TEST定义，也是类似的定义。
....
#ifdef TEST
#undef TEST
#endif
....
例如：
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
温馨提示：以上两种定义，不能直接定义成如下形式
#ifndef TEST // (It's wrong!)
#undef TEST // (It's wrong!)
2、情形2
此时的main函数关心的是使程序可移植。这可以如下来实现：
......
main()
{
...
#ifdef IBM_PC
{
//the codes are for IBM_PC
...
}
#else
{
//the codes are for HP_PC
....
}
#endif
....
}
如果我们想让程序在IBM_PC机上运行，可以在程序中包含如下指令：
#define IBM_PC
否则就不需要。注意，编译器控制指令位于函数之中，还有注意把#字符放在该行的第一列中。
如果定义了IBM_PC，编译器将编译针对IBM_PC的代码；如果没有，则编译针对HP_PC的代码。
以下举个实例：
switch(MonDriver.OnRunFunction)
{
case DIALFUN:
switch(byModemRet)
{
case MRES_CONN:
#ifdef DETTCPIP
PostAppMessage(_iappTCPIP,EV_MCONNECT,1,0);
//connect OK,
#endif
MonDriver.RunStatus=ONLINE;
MonDriver.OnRunFunction=NOMDFUN;
break;
case MRES_TONE:
#ifdef DETTCPIP
//if no dial tone, send message to ppp
PostAppMessage(_iappTCPIP,EV_MCONNECT,4,0);
#endif
MonDriver.RunStatus=IDLE;
MonDriver.OnRunFunction=NOMDFUN;
break;
case MRES_ERR:
case MRES_NO:
case MRES_BUSY:
#ifdef DETTCPIP
PostAppMessage(_iappTCPIP,EV_MCONNECT,2,0);
//the line is busy, send message to ppp
#endif
MonDriver.RunStatus=IDLE;
MonDriver.OnRunFunction=NOMDFUN;
break;
default:
break;
}
3、情形3
这种情形类似于情形2，因此控制指令的形式如下：
#ifdef ABC
group-A lines
#else
group-B lines
#endif
如果定义了ABC，则包含group-A 代码行；否则包含group-B 代码行。
例如：
#ifdef PIAFS_DATA_MODEM
byBuf[0] = SID_APP_PHS;
#else
byBuf[0] = 0xFF;
#endif
4、情形4
进行调试和测试是为了检测程序中的错误。编译器可以检测出语法和语义错误，但不能
检测错误的算法，当程序运行时，将产生错误的结果。
错误检测和隔离的过程首先是用已知的测试数据集对程序进行测试。程序分成几部分，在
不同的地方放置printf语句以显示中间结果。这种语句称为调试语句。一旦把错误隔离并
修正后就不再需要了。此时，我们可以把这些语句删掉，或使用如下控制指令来使它们
不再为活动的。
......
#ifdef TEST
{
printf("Array elements\");
for(i = 0; i < m; i ++)
printf("x[%d] = %d\n",i, x[i]);
}
#endif
.....
#ifdef TEST
printf(....);
#endif
只有定义了宏TEST，才包含位于#ifdef和#endif之间的语句。一旦所有事情都搞定了，就可以
删除或者取消TEST的定义。这样可以使得#ifdef TEST条件为假，因而所有测试语句都被忽略。
C预处理器还支持一个更通用的测试条件形式，即#if指令，其形式如下：
#if constant_expression
{
statement-1;
statement-2;
.....
}
#endif
例如 1：
#if defined(PIAFS_DATA_MODEM) && !defined(_ONPC_)
UChar g_PiafsStatus;
extern void pf_set_dpdial_state(unsigned char state);
extern void pf_set_dp_state(unsigned char state);
#endif //PIAFS_DATA_MODEM
例如 2：
#if defined YAMAHA759 || \
defined YAMAHA762 || \
defined YAMAHA757 || \
defined OKI_2870 || \
defined SUNPLUS||\
defined WINBOND
Bios_SetRingVolume(0x1f);
MusicPlay(1);
#endif
例如 3：
#if PHONE_TEST
extern _BYTE addSchedule(_BYTE *pBuf);//buf 128
#endif
constant_expression可以是以下任意形式的表达式：
TEST <=3
(LEVEL == 1||LEVEL == 2)
MACHINE == 'A'
如果constant_expression为非零（即为真），那么位于#if 和 #endif之间的语句都被处理；
否则被忽略。TEST、LEVEL等名称也可以定义为宏。
ANSI C 的其他预处理器指令
#elif 提供另一种测试方法
#pragma 指定某些指令
#error 当发生错误时停止编译工作
ANSI 标准还包括了两个新的预处理器操作：
# 字符串化运算符
## 标记符粘贴运算符
部分指令举例如下：
1、#elif指令
#elif指令用来构建“if...else...if”语句系列，用于测试多种条件情况。
它的一般形式如下
#if expression 1
statement sequence 1
#elif expression 2
statement sequence 2
....
#elif expression N
statement sequence N
#endif
例如：
#ifdef __H300__
#define _CAL_FONT_BACK_COLOR __RGB(255,247,153)
#define _CAL_PEN_COLOR __RGB(192,180,2)
#elif defined(__SS71C__) || defined(__SS72C__)
#define _CAL_PEN_COLOR __RGB(255,255,255)
#define _CAL_FONT_BACK_COLOR __RGB(246,213,151)
#endif
2、#pragma指令
#pragma是基于实现的指令，可以用来指定提交给编译器的不同命令。其形式如下：
#pragma name
其中，name为想要的pragma名，例如在microsoft c环境下：
#pragma loop_opt(on) 将会使循环优化后执行。如果编译器不能识别它，则被忽略。
3、#error指令
#error指令用于在调试时产生诊断消息，其形式如下：
#error error message
当遇到#error指令时，显示错误消息并终止处理。例如：
#ifndef FILE_G (或者这句这样说#if !define (FILE_G))
#error NO GRAPHICS FACILTY
#endif
注意：这里与#if一起使用的是一个特殊的处理器运算符defined。Defined是一个新添加的指令，带有由括号括起来的name。如果编译器不支持它，可以进行如下替换：
用 #ifndef 替换 #if !defined
用 #ifdef 替换 #if defined
4、#字符串化运算符
#字符串化的运算符，用在宏函数的定义中。作用：该运算符允许在宏定义中使用一个形参，它将被转化为一个字符串。例如
#define sum（xy） printf（#xy“ = %f\n”， xy）
sum(a+b);
预处理器竟把下面语句行：sum（a+b）转换为printf(“a+b” “= %f \n”,a+b);
该语句又等价于 printf(“a + b = %f \n”,a + b);
ANSI标准还规定，相邻字符串将连接起来。
5、##标记符粘贴运算符
ANSI标准定义的标记符粘贴运算符##可以把宏定义中的两个标记符组合成一个标记符。
例如 #define combine (s1, s2) s1##s2
Combine(TOTAL,SALES)则为 TOTALSALES
(结束)
相关阅读 更多 +
