防止重复定义头文件

在 STM32 标准库的所有头文件以及我们自己编写的“bsp_led.h”头文件中，可看到类似如下代码的宏定义。它的功能是防止头文件被重复包含，避免引起编译错误。

1 #ifndef __LED_H
2 #define __LED_H
3
4 /* 此处省略头文件的具体内容 */
5
6 #endif /* end of __LED_H */

在头文件的开头，使用“#ifndef”关键字，判断标号“__LED_H”是否被定义，若没有被定义，则从“#ifndef”至“#endif”关键字之间的内容都有效，也就是说，这个头文件若被其它文件“#include”，头文件就会被包含到这个文件中了，且头文件中紧接着使用“#define”关键字定义上面判断的标号“__LED_H”。当这个头文件被同一个文件第二次“#include”包含时，因为存在第一次包含中的“#define__LED_H”定义，这时再判断“#ifndef__LED_H”，判断的结果就是该文件已经包含过头文件了，从“#ifndef”至#endif”之间的内容都无效，从而防止了同一个头文件被包含多次，编译时就不会出现“redefine（重复定义）”的错误了。

至于为什么要用两个下划线来定义“__LED_H”标号，其实这只是防止它与其它普通宏定义重复了，如我们用“GPIO_PIN_2”来代替这个判断标号，就会因为stm32f4xx.h已经定义了GPIO_PIN_2，结果导致“bsp_led.h”文件无效了，“bsp_led.h”文件一次都没被包含。