C语言预处理命令（精品）

原文出处：
https://www.cnblogs.com/clover-toeic/p/3851102.html

一 前言

预处理(或称预编译)是指在进行编译的第一遍扫描(词法扫描和语法分析)之前所作的工作。预处理指令指示在程序正式编译前就由编译器进行的操作，可放在程序中任何位置。

预处理是C语言的一个重要功能，它由预处理程序负责完成。当对一个源文件进行编译时，系统将自动引用预处理程序对源程序中的预处理部分作处理，处理完毕自动进入对源程序的编译。

C语言提供多种预处理功能，主要处理#开始的预编译指令，如宏定义(#define)、文件包含(#include)、条件编译(#ifdef)等。合理使用预处理功能编写的程序便于阅读、修改、移植和调试，也有利于模块化程序设计。

二 宏定义

C语言源程序中允许用一个标识符来表示一个字符串，称为“宏”。被定义为宏的标识符称为“宏名”。在编译预处理时，对程序中所有出现的宏名，都用宏定义中的字符串去代换，这称为宏替换或宏展开。

宏定义是由源程序中的宏定义命令完成的。宏替换是由预处理程序自动完成的。

在C语言中，宏定义分为有参数和无参数两种。下面分别讨论这两种宏的定义和调用。

2.1 无参宏定义

无参宏的宏名后不带参数。其定义的一般形式为：

#define  标识符  字符串

其中，“#”表示这是一条预处理命令(以#开头的均为预处理命令)。“define”为宏定义命令。“标识符”为符号常量，即宏名。“字符串”可以是常数、表达式、格式串等。

宏定义用宏名来表示一个字符串，在宏展开时又以该字符串取代宏名。这只是一种简单的文本替换，预处理程序对它不作任何检查。如有错误，只能在编译已被宏展开后的源程序时发现。

注意理解宏替换中“换”的概念，即在对相关命令或语句的含义和功能作具体分析之前就要进行文本替换。
【例1】定义常量：`#define MAX_TIME 1000

若在程序里面写if(time < MAX_TIME){…}，则编译器在处理该代码前会将MAX_TIME替换为1000。

注意，这种情况下使用const定义常量可能更好，如const int MAX_TIME = 1000;。因为const常量有数据类型，而宏常量没有数据类型。编译器可以对前者进行类型安全检查，而对后者只进行简单的字符文本替换，没有类型安全检查，并且在字符替换时可能会产生意料不到的错误。
`
【例2】反例：

#define pint (int*)
pint pa, pb;
本意是定义pa和pb均为int型指针，但实际上变成int* pa,pb;。pa是int型指针，而pb是int型变量。本例中可用typedef来代替define，这样pa和pb就都是int型指针了。

因为宏定义只是简单的字符串代换，在预处理阶段完成，而typedef是在编译时处理的，它不是作简单的代换，而是对类型说明符重新命名，被命名的标识符具有类型定义说明的功能。

无参宏注意事项：

宏名一般用大写字母表示，以便于与变量区别。宏定义末尾不必加分号，否则连分号一并替换。宏定义可以嵌套。

可用#undef命令终止宏定义的作用域。

使用宏可提高程序通用性和易读性，减少不一致性，减少输入错误和便于修改。如数组大小常用宏定义。预处理是在编译之前的处理，而编译工作的任务之一就是语法检查，预处理不做语法检查。宏定义写在函数的花括号外边，作用域为其后的程序，通常在文件的最开头。字符串" "中永远不包含宏，否则该宏名当字符串处理。
宏定义不分配内存，变量定义分配内存。

2.2 带参宏定义

C语言允许宏带有参数。在宏定义中的参数称为形式参数，在宏调用中的参数称为实际参数。

对带参数的宏，在调用中，不仅要宏展开，而且要用实参去代换形参。

带参宏定义的一般形式为：
#define 宏名(形参表) 字符串

在字符串中含有各个形参。

带参宏调用的一般形式为：
宏名(实参表);

在宏定义中的形参是标识符，而宏调用中的实参可以是表达式。

在带参宏定义中，形参不分配内存单元，因此不必作类型定义。而宏调用中的实参有具体的值，要用它们去代换形参，因此必须作类型说明，这点与函数不同。函数中形参和实参是两个不同的量，各有自己的作用域，调用时要把实参值赋予形参，进行“值传递”。而在带参宏中只是符号代换，不存在值传递问题。

【例3】

#define INC(x) x+1 //宏定义
y = INC(5); //宏调用

在宏调用时，用实参5去代替形参x，经预处理宏展开后的语句为y=5+1。

【例4】反例：

#define SQ® r*r

上述这种实参为表达式的宏定义，在一般使用时没有问题；但遇到如area=SQ(a+b);时就会出现问题，宏展开后变为area=a+b*a+b;，显然违背本意。

相比之下，函数调用时会先把实参表达式的值(a+b)求出来再赋予形参r；而宏替换对实参表达式不作计算直接地照原样代换。因此在宏定义中，字符串内的形参通常要用括号括起来以避免出错。

进一步地，考虑到运算符优先级和结合性，遇到area=10/SQ(a+b);时即使形参加括号仍会出错。因此，还应在宏定义中的整个字符串外加括号，

综上，正确的宏定义是#define SQ® (®*®)，即宏定义时建议所有的层次都要加括号。

【例5】带参函数和带参宏的区别：

 #define SQUARE(x) ((x)*(x))

 int Square(int x){

   return (x * x); //未考虑溢出保护

}

int main(void){

    int i = 1;

   while(i <= 5)

       printf("i = %d, Square = %d\n", i, Square(i++));

   int j = 1;

   while(j <= 5)

      printf("j = %d, SQUARE = %d\n", j, SQUARE(j++));
  return 0;

 }

执行后输出如下：

i = 2, Square = 1

i = 3, Square = 4

i = 4, Square = 9

i = 5, Square = 16

i = 6, Square = 25

j = 3, SQUARE = 1

j = 5, SQUARE = 9

j = 7, SQUARE = 25

本例意在说明，把同一表达式用函数处理与用宏处理两者的结果有可能是不同的。

调用Square函数时，把实参i值传给形参x后自增1，再输出函数值。因此循环5次，输出1～5的平方值。调用SQUARE宏时，SQUARE(j++)被代换为((j++)(j++))。在第一次循环时，表达式中j初值为1，两者相乘的结果为1。相乘后j自增两次变为3，因此表达式中第二次相乘时结果为33=9。同理，第三次相乘时结果为5*5=25，并在此次循环后j值变为7，不再满足循环条件，停止循环。

从以上分析可以看出函数调用和宏调用二者在形式上相似，在本质上是完全不同的。

带参宏注意事项：
宏名和形参表的括号间不能有空格。
宏替换只作替换，不做计算，不做表达式求解。
函数调用在编译后程序运行时进行，并且分配内存。宏替换在编译前进行，不分配内存。
函数只有一个返回值，利用宏则可以设法得到多个值。
宏展开使源程序变长，函数调用不会。
宏展开不占用运行时间，只占编译时间，函数调用占运行时间(分配内存、保留现场、值传递、返回值)。
为防止无限制递归展开，当宏调用自身时，不再继续展开。
如：#define TEST(x) (x + TEST(x))被展开为1 + TEST(1)。

2.3 实践用例

包括基本用法(及技巧)和特殊用法(#和##等)。

#define可以定义多条语句，以替代多行的代码，但应注意替换后的形式，避免出错。宏定义在换行时要加上一个反斜杠”\”，而且反斜杠后面直接回车，不能有空格。

2.3.1 基本用法

1. 定义常量：

#define PI 3.1415926
将程序中出现的PI全部换成3.1415926。

2. 定义表达式：
   #define M (yy+3y)

编码时所有的表达式(yy+3y)都可由M代替，而编译时先由预处理程序进行宏替换，即用(yy+3y)表达式去置换所有的宏名M，然后再进行编译。

注意，在宏定义中表达式(yy+3y)两边的括号不能少，否则可能会发生错误。如s=3M+4M在预处理时经宏展开变为s=3*(yy+3y)+4*(yy+3y)，如果宏定义时不加括号就展开为s=3yy+3y+4yy+3y，显然不符合原意。因此在作宏定义时必须十分注意。应保证在宏替换之后不发生错误。

3. 得到指定地址上的一个字节或字：

#define MEM_B(x) (*((char )(x)))
#define MEM_W(x) (((short *)(x)))

4. 求最大值和最小值：

#define MAX(x, y) (((x) > (y)) ? (x) : (y))
#define MIN(x, y) (((x) < (y)) ? (x) : (y))

以后使用MAX (x,y)或MIN (x,y)，就可分别得到x和y中较大或较小的数。

但这种方法存在弊病，例如执行MAX(x++, y)时，x++被执行多少次取决于x和y的大小；当宏参数为函数也会存在类似的风险。所以建议用内联函数而不是这种方法提高速度。不过，虽然存在这样的弊病，但宏定义非常灵活，因为x和y可以是各种数据类型。

5. 得到一个成员在结构体中的偏移量(lint 545告警表示"&用法值得怀疑"，此处抑制该警告)：

#define FPOS(type, field)
/*lint -e545 */ ((int)&((type *)0)-> field) /*lint +e545 */

6. 得到一个结构体中某成员所占用的字节数：

#define FSIZ(type, field) sizeof(((type *)0)->field)

7. 按照LSB格式把两个字节转化为一个字(word)：

#define FLIPW(arr) ((((short)(arr)[0]) * 256) + (arr)[1])

8. 按照LSB格式把一个字(word)转化为两个字节：

#define FLOPW(arr, val)
(arr)[0] = ((val) / 256);
(arr)[1] = ((val) & 0xFF)

9. 得到一个变量的地址：

#define B_PTR(var) ((char *)(void *)&(var))
#define W_PTR(var) ((short *)(void *)&(var))

10. 得到一个字(word)的高位和低位字节：

#define WORD_LO(x) ((char)((short)(x)&0xFF))
#define WORD_HI(x) ((char)((short)(x)>>0x8))

11. 返回一个比X大的最接近的8的倍数：

#define RND8(x) ((((x) + 7) / 8) * 8)

12. 将一个字母转换为大写或小写：

#define UPCASE© ((© >= ‘a’ && © <= ‘z’) ? (© + ‘A’ - ‘a’) : ©)
#define LOCASE© ((© >= ‘A’ && © <= ‘Z’) ? (© + ‘a’ - ‘A’) : ©)

注意，UPCASE和LOCASE宏仅适用于ASCII编码(依赖于码字顺序和连续性)，而不适用于EBCDIC编码。

13. 判断字符是不是10进值的数字：

#define ISDEC© (© >= ‘0’ && © <= ‘9’)

14. 判断字符是不是16进值的数字：

#define ISHEX© ((© >= ‘0’ && © <= ‘9’) ||\

 ((c) >= 'A' && (c) <= 'F') ||\

 ((c) >= 'a' && (c) <= 'f'))

15. 防止溢出的一个方法：

#define INC_SAT(val) (val = ((val)+1 > (val)) ? (val)+1 : (val))
16. 返回数组元素的个数：

#define ARR_SIZE(arr) (sizeof((arr)) / sizeof((arr[0])))

17. 对于IO空间映射在存储空间的结构，输入输出处理：
    #define INP(port) (*((volatile char *)(port)))

#define INPW(port) (*((volatile short *)(port)))

#define INPDW(port) (*((volatile int *)(port)))

#define OUTP(port, val) (*((volatile char *)(port)) = ((char)(val)))

#define OUTPW(port, val) (*((volatile short *)(port)) = ((short)(val)))

#define OUTPDW(port, val) (*((volatile int *)(port)) = ((int)(val)))

18取消宏定义：
#define [MacroName] [MacroValue] //定义宏

#undef [MacroName] //取消宏