C语言程序环境和预处理Pt.2 - 宏的命名约定|#undef|命令行定义|条件编译

Pt1:

C语言程序环境和预处理Pt.1 - 预处理指令|预处理操作符-CSDN博客https://blog.csdn.net/BuiderCodes/article/details/136620859

---

1.宏的命名约定

1. 清晰明了：宏的名称应该清晰地表达其功能或目的，使读者能够迅速理解其作用。注意不要使用中文拼音！这样的宏名很难以理解，用英文单词会使读者快速理解。

2. 使用大写字母：通常约定宏名称全部使用大写字母，以便与函数区别开来，因为函数一般用小写命名，这样能更好区分宏和函数。

3. 下划线分隔：在多个单词构成的宏名称中使用下划线分隔，以增强可读性。例如：MAX_LENGTH。

4. 避免与关键字冲突：确保宏名称不与语言的关键字或其他已经存在的标识符冲突。

2. #undef 

#undef 是一个预处理器指令，用于取消定义一个已经定义的宏。通过#undef，可以在之后重新定义或者删除已经定义的宏。

例如，运行下面这段代码，将会输出

“MAX”未定义；假设外部返回 int

#define MAX(x,y) ((x)>(y))?(x):(y)
int main()
{
	int a = 1;
	int b = 2;
	int c = MAX(a, b);
#undef MAX
	int d = MAX(a, b);

	return 0;
}

3. 命令行

在命令行中，可以使用 -D 选项来定义一个宏。这在编译时可以用来传递参数给预处理器。

例如，在使用 GCC 编译器时，我们可以通过下面这个指令来定义宏：

gcc -DDEBUG main.c -o main

4.条件编译 

条件编译指令是在编译过程中根据预定义的条件选择性地包含或排除代码块。主要的条件编译指令包括：

 #ifdef：检查某个宏是否已经定义，如果定义了，则编译后面的代码块。

#ifdef DEBUG
    // 在 DEBUG 模式下执行的代码
#endif

要注意，与if不同的是，#ifdef 后面的判断内容不用加括号，而且，if判断为假不会删除代码块里面的内容，而编译指令#ifdel做的事是直接在预处理阶段对条件做判断，为假直接删除代码块内的内容。

#ifndef：与 #ifdef 相反，检查某个宏是否未定义，如果未定义，则编译后面的代码块。

#ifndef DEBUG
    // 在非 DEBUG 模式下执行的代码
#endif
#ifndef DEBUG
    // 在非 DEBUG 模式下执行的代码
#endif

#if：基于表达式的结果来选择性地编译代码块。

#if defined(DEBUG) && DEBUG == 1
    // 在 DEBUG 定义且值为 1 时执行的代码
#endif

#if 决定的是什么条件下编译什么代码，而if决定的是什么情况下执行什么代码。

#elif：在多个条件之间进行选择，与 #if 或 #ifdef 一起使用。

#ifdef DEBUG
    // 在 DEBUG 模式下执行的代码
#elif defined(TEST)
    // 在 TEST 模式下执行的代码
#else
    // 默认情况下执行的代码
#endif

#else：与 #ifdef 或 #ifndef 一起使用，指定未满足前面条件时要编译的代码块。

#ifdef DEBUG
    // 在 DEBUG 模式下执行的代码
#else
    // 在非 DEBUG 模式下执行的代码
#endif

#endif：结束条件编译块。

#ifdef DEBUG
    // 在 DEBUG 模式下执行的代码
#endif

 上述指令还可以嵌套使用，比如

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

条件编译用在开发跨平台应用程序时，可能需要根据不同的操作系统或编译器设置不同的编译选项。条件编译可以根据不同平台的特性选择性地编译适配的代码。

比如一份代码为windows和linux两个平台各写了一份代码，就可以用条件编译指令来编译对应平台的代码。

5.文件包含

C语言中的头文件包含是通过 #include 预处理指令实现的。例如，#include <stdio.h> 将标准输入输出库的声明包含到程序中，使得 printf() 函数可以被使用。

C语言中的包含方法有两种：

1. 使用尖括号`<>`
   
   这种方式用于包含标准库头文件或系统提供的头文件。编译器会在系统默认的路径中查找这些头文件。
   如果在系统默认路径下找不到则会报错。
   
2. 使用双引号`""`
   这种方式用于包含自定义的头文件或者当前工作目录下的头文件。编译器会先在当前目录下查找头文件，如果找不到再去系统默认路径查找。

那是否就是说所有的文件都可以用`""` 来包含呢？

理论上是可以的，但是这样做查找的效率就会变低，而且这样也容易混淆库文件和本地文件。

 现在再来看看这样的情况：

pub.h是公用模块，test1和test2同时调用了pub.h，而test又同时调用了test1 和 test2，这样一来，test.h中就包含了两份pub.h的内容，为了避免这种情况，我们有两种解决方法：

1. 使用条件编译

#ifndef __PUB_H__
#define __PUB_H__

//pub.h的内容

#endif

我们看到很多系统头文件里面的条件编译语句都是为了防止文件重复包含的。 

 2.使用#pragma once

#pragma once

//pub.h的内容