C语言 -- 预定义、宏与函数、条件编译

预处理详解

预定义符号

__FILE__ //进行编译的源文件
__LINE__ //文件当前的行号
__DATE__ //文件被编译的日期
__TIME__ //文件被编译的时间
__STDC__ //如果编译器遵循ANSI C，其值为1，否则未定义

以上的这些预定义符号都是语言内置的，比如：

void main()
{
	printf("file:%s \nline:%d\n", __FILE__, __LINE__);
}

执行以上代码，可以看到运行结果（以我的程序为例）：

#define

#define 定义标识符

语法：

#define name stuff

例如：

#define MAX 100 
#define reg register //为register这个关键字，创建一个简短的名字
#define CASE break;case //在写case的时候自动把break加上

一个建议：建议在define定义标识符的时候，不要在最后加上;，加分号容易出现问题，比如说：

#define MAX 100;
void main()
{
	int max = MAX;
}

会出现语法错误

#define 定义宏

#define机制包括了一个规定，允许把参数替换到文本中，这种实现通常称为宏（macro）或者定义宏（define macro）。

宏的声明方式：
#define name(parament-list) stuff 其中的 parament-list 是一个由逗号隔开的符号表，他们可能出现在stuff中

• 注意：参数列表的左括号必须与name紧邻。如果两者之间有任何空白存在，参数列表就会被解释为stuff的一部分

观察以下例子：

#include<stdio.h>
#define SQUARE(x) x*x

void main()
{
	int a = 5;
	printf("%d\n", SQUARE(a + 1)); //11
	//SQUARE(a+1)---a+1*a+1 = a+1*1+5 = 11
}

可以很明显看出，我们想到的值为36，但是实际输出的值却为11，这是因为替换文本的问题。
做出如下修改：

#include<stdio.h>
#define SQUARE(x) (x)*(x)

void main()
{
	int a = 5;
	printf("%d\n", SQUARE(a + 1)); //36
	//SQUARE(a+1)---(a+1)*(a+1) = 6*6 = 36
}

再观察如下代码：

#include<stdio.h>
#define DOUBLE(x) (x)+(x)

void main()
{
	int a = 5;
	printf("%d\n", 10 * DOUBLE(a)); //55
	//10*(5)+(5) = 55
}

虽然加了括号，但是得到的结果也还不是想要的，修改如下：

#include<stdio.h>
#define DOUBLE(x) ((x)+(x))

void main()
{
	int a = 5;
	printf("%d\n", 10 * DOUBLE(a)); //100
}

• 结论：用于对数值表达式进行求值的宏定义都应该用上述这种方式加上括号，避免在使用宏时由于参数中的操作符或邻近操作符之间不可预料的相互作用

#define 替换规则

在程序中扩展#define定义符号和宏时，需要涉及几个步骤：

1. 在调用宏时，首先对参数进行检查，看看是否包含任何由#define定义的符号。如果是，它们首先被替换
2. 替换文本随后被插入到程序中原来文本的位置。对于宏，参数名被他们的值替换
3. 最后，再次对结果文件进行扫描，看看它是否包含任何由#define定义的符号。如果是，就重复上述处理过程

#和##

如何把参数插入到字符串中？
观察如下代码：

#include<stdio.h>
void main()
{
	char* p = "hello ""bit\n";
	printf("%s", p); //hello bit
}

从打印结果可以看出，字符串是有自动连接的特点的。

1. 只有当字符串作为宏参数的时候才可以把字符串放在字符串中

#include<stdio.h>
#define PRINT(FORMAT, VALUE) printf("the value is "FORMAT"\n", VALUE);
void main()
{
	int i = 10;
	PRINT("%d", i + 3); //the value is 13
}

2. 使用#，把一个宏参数变成对应的字符串

#include<stdio.h>
#define PRINT(FORMAT, VALUE)\
        printf("the value of "#VALUE" is "FORMAT"\n", VALUE);
void main()
{
	int i = 10;
	PRINT("%d", i+3); //the value of i+3 is 13
}

3. ##的用法

##可以把位于它两边的符号合成一个符号。它允许宏定义从分离的文本片段创建标识符

#include<stdio.h>
#define ADD_TO_SUM(num,value) sum##num += value;
void main()
{
	int sum1 = 0;
	int sum7 = 3;

	printf("sum1=%d  sum7=%d\n", sum1, sum7); //sum1=0  sum7=3

	ADD_TO_SUM(1, 1); //给sum1增加1；
	ADD_TO_SUM(7, 1); //给sum7增加1；

	printf("sum1=%d  sum7=%d\n", sum1, sum7); //sum1 = 1  sum7 = 4
}

注：这样的连接必须产生一个合法的标识符。否则其结果就是未定义的。

带副作用的宏参数

当宏参数在宏的定义中出现超过一次的时候，如果参数带有副作用，那么在使用这个宏的时候就可能造成不可预测的后果。
副作用就是表达式求值的时候出现的永久性效果。
例如：

x+1 //不带副作用
x++ //带有副作用

观察下面的代码：

#include<stdio.h>
#define MAX(a,b) ((a)>(b)?(a):(b))
void main()
{
	int x = 5;
	int y = 8;
	int z = MAX(x++, y++);
	//z = MAX(x++, y++) = ((x++)>(y++)?(x++):(y++))
	printf("x=%d\ny=%d\nz=%d\n", x,y,z); //x=6 y = 10 z = 9
}

宏和函数对比

宏通常被应用于执行简单的运算。比如在两个数中找出较大的一个。

#define MAX(a,b) ((a)>(b)?(a):(b))

那么用函数来完成这个任务和用宏完成有什么不同：

1. 用于调用函数和从函数返回的可能比实际执行这个小型计算工作所需要的时间更多。所以宏比函数在程序的规模和速度方面更胜一筹
2. 更为重要的是函数的参数必须声明为特定的类型。所以函数只能在类型合适的表达式上使用。反之这个宏怎可以适用于整型、长整型、浮点型等可以用于>来比较的类型。宏是类型无关的

当然和宏相比函数也有劣势的地方：

1. 每次使用宏的时候，一份宏定义的代码将插入到程序中。除非宏比较短，否则可能大幅度增加程序的长度
2. 宏是没法调试的
3. 宏由于类型无关，也就不够严谨
4. 宏可能会带来运算符优先级的问题，导致程序容易出错

宏有时候可以做到函数做不到的事情。比如：宏的参数可以出现类型，但是函数做不到。

#include<stdio.h>
#define MALLOC(num, type)\
(type*)malloc(num*sizeof(type))

void main()
{
	int* p = MALLOC(10, int);
	if (p == NULL)
	{
		return;
	}
	for (int i = 0; i < 10; i++)
	{
		p[i] = i + 1;
	}
	for (int i = 0; i < 10; i++)
	{
		printf("%d ", p[i]);
	}
	free(p);
}

宏和函数的对比表

属性	#define 定义宏	函数
代码长度	每次使用时，宏代码都会被插入到程序中，除了非常小的宏之外，程序的长度会大幅增长	函数代码只出现于一个地方；每次使用这个函数时，都调用那个地方的同一份代码
执行速度	更快	存在函数的调用和返回的额外开销，所以相对慢一些
操作符优先级	宏参数的求值是在所有周围表达式的上下文环境里，除非加上括号，否则临近操作符的优先级可能会产生不可预料的后果，所以建议宏在书写的时候多些括号	函数参数只在函数调用的时候求值一次，它的结果值传给函数。表达式的求值结果更容易预测
带有副作用的参数	参数可能被替换到宏体中的多个位置。所以带有副作用的参数求值可能会产生不可预料的后果	函数参数只在传参的时候求职一次，结果更容易控制。
参数类型	宏的参数与类型无关，只要对参数的操作是合法的，它就可以使用于任何参数类型	函数的参数是与类型有关的，如果参数的类型不同，就需要不用的参数，即使他们执行的任务是不同的
调试	宏是不方便调试的	函数是可以逐语句调试的
递归	宏是不能递归的	函数是可以递归的

命名约定

一般来讲函数与宏的使用语法很相似，多以语言本身没法帮我们区分二者，但作为编写者，平时的一个习惯是：

把宏名全部大写
函数名不要全部大写（驼峰式命名）

#undef

这条指令用于移除一个宏定义

#undef NAME
//如果现存的一个名字需要被重新定义，那么它的旧名字首先要被移除

命令行定义

许多C的编译器提供了一种能力，允许在命令行中定义符号。用于启动编译过程。例如：当我们根据同一个源文件要编译出不同的一个程序的不同版本的时候，这个特性就有其用武之地。

#include <stdio.h>
int main()
{
	int array[ARRAY_SIZE];
	int i = 0;
	for (i = 0; i < ARRAY_SIZE; i++)
	{
		array[i] = i;
	}
	for (i = 0; i < ARRAY_SIZE; i++)
	{
		printf("%d ", array[i]);
	}
	printf("\n");
	return 0;
}

编译指令：

gcc -D ARRAY_SIZE=10 programe.c

条件编译

在编译一个程序的时候如果要将一条语句（一组语句）编译或者放弃是很方便的。
比如：

调试性的代码，删除可惜，保留又碍事，所以可以选择性的编译

常见的条件编译指令：

1. #if 常量表达式 … #endif

#define DEBUG 1
#if DEBUG
	//...
#endif

2. 多个分支的条件编译

#if 常量表达式
	//...
#elif 常量表达式
	//...
#else
	//...
#endif

3. 判断是否被定义

#if defined(symbol)
#ifdef symbol

#if !defined(symbol)
#ifndef symbol

4. 嵌套指令

#if defined(OS_UNIX)
	#ifdef OPTION1
		unix_version_option1();
	#endif
	#ifdef OPTION2
	    unix_version_option2();
	#endif
#elif defined(OS_MSDOS)
	#ifdef OPTION2
		unix_version_option2();
	#endif
#endif

文件包含

#include 指令可以使另外一个文件被编译。就像它实际出现于#include指令的地方一样

这种替换方式很简单：预处理器先删除这条指令，并用包含文件的内容替换。这样一个源文件被包含10次，那就实际被编译10次

头文件被包含的方式

• 本地文件包含

#include "filename"

查找策略：先在源文件所在目录下查找，如果该头文件未找到，编译器就像查找库函数头文件一样在标准位置查找头文件。如果找不到就提示编译错误。

• 库文件包含

#include <filename.h>

查找头文件直接区标准路径下去查找，如果找不到就提示编译错误。