C++ Include Guard

在 C++ 中，头文件被广泛使用以便于代码的重用。然而，当多个文件包含相同的头文件时，会导致重定义错误。为了解决这个问题，我们需要使用 include guard。

Include guard 是一种预处理器指令，可以确保每个头文件只被编译一次。当头文件被重复包含时，include guard 会防止编译器再次处理头文件。这能够避免重定义错误并大大降低编译时间。

使用方法

为了使用 include guard，我们需要在头文件的开头和结尾都添加以下指令：

#ifndef HEADER_NAME_H
#define HEADER_NAME_H

// Header file contents go here

#endif // HEADER_NAME_H

其中，HEADER_NAME_H 可以被替换成任何唯一的标识符。通常我们使用头文件的文件名作为标识符，加上后缀 _H 或 _INCLUDED。

在头文件开头的 #ifndef 指令中，我们检查该标识符是否已经被定义。如果没有，我们定义该标识符并继续编译头文件的内容。在头文件结尾的 #endif 指令中，我们取消定义该标识符。

示例

以下是一个典型的头文件（MyHeader.h）中使用 include guard 的示例：

#ifndef MY_HEADER_H
#define MY_HEADER_H

#include <iostream>

void hello() {
    std::cout << "Hello, World!" << std::endl;
}

#endif // MY_HEADER_H

当我们在多个文件中包含该头文件时，只会编译一次该头文件的内容。这避免了重定义错误并提高了编译效率。

现在，你已经了解了如何使用 include guard 来确保每个头文件只被编译一次。这是 C++ 中非常重要的一个概念，掌握它将有助于您编写更加可靠和高效的程序。