C/C++语言中头文件的保护宏

什么是保护宏

保护宏就是C/C++头文件开始处的宏判断和宏定义，可以避免该头文件被多次加载执行而导致编译错误的宏。

示例代码如下：

#ifndef __PROTECT_TEST_H
#define __PROTECT_TEST_H

#define SUCCESS		1
#define FAILED		0

#endif /*__PROTECT_TEST_H*/

上述代码所在的头文件名是 “ protect_test.h ” ，代码片段中第1、2和7行就是保护宏的实现。

保护宏的作用

使用保护宏可以避免一个头文件被多次包含而造成的编译错误。例如：上述代码片段中，如果我们没有使用保护宏，而定义了宏“SUCCESS”和宏“FAILED”，则“prote ct_test.h ”文件不能被多次包含，否则编译时会提示变量重复定义的错误。而当加上保护宏之后，第一次包含该头文件时，代码片段第1行判断宏“ __PROTECT_TEST_H”的时候该宏还没有定义，程序会继续往下执行，代码片段第2行就会定义“__PROTECT_TEST_H”宏，这样，当第二次包含时，保护宏就会起作用，代码片段第1行判断时发现“__PROTECT_TEST_H”宏已经被定义，就不会继续往下执行了，这样后面的代码就无效了，进而避免了编译时出现的重复定义的错误。

保护宏的命名规则

每个头文件中保护宏的名字（如示例代码片段中的“__PROTECT_TEST_H”）应当不同。如果相同，则具有相同保护宏的头文件不能被同一个C文件包含。因此，需要制定保护宏的命名规则，其规则如下：

1.以文件名为基础构建宏名，比如示例文件名为“protect_test.h”

2.将文件名中的“.”转换成“_”，成为“protect_test_h”

3.全部字符转换成大写，成为“PROTECT_TEST_H”

4.最后在前面添加两个“_”，成为完整的保护宏“__PROTECT_TEST_H”

因此，只要文件名不同，保护宏的名字也就不一样了。