源文件包含

将其他源文件包含到当前源文件中紧随指令之后的一行。

语法

容许任何预处理记号（宏常量或表达式）作为给 #include å’Œ __has_include (C++17 èµ·)的实参，只要它们展开成 < > 或 " " 所环绕的字符序列即可。

解释

注意

包含一个文件时，它将经过翻译阶段 1-4 的处理，这可能递归地包含嵌套 #include 指令的展开。为避免（可能传递性地）重复包含相同文件，和由文件包含自身造成的无限递归，常使用头文件防护：整个头文件被包装在下列结构中

#ifndef FOO_H_INCLUDED /* 任何唯一地映射到文件的名称 */
#define FOO_H_INCLUDED
// 文件内容在此
#endif

许多编译器亦实现有类似效果的非标准 编译选项（pragma） #pragma once：若已包含了同一文件（这里以特定于 OS 的方式确定文件的身份），则禁止处理该文件。

1 çš„ __has_include 结果仅表明存在有指定名称的头或源文件。它并不意味着包含该头或源文件时不会导致错误，或其会包含任何有意的内容。例如在同时支持 C++14 å’Œ C++17 模式（并在其 C++14 模式作为一项遵从标准的扩展而提供 __has_include）的 C++ 实现上，__has_include(<optional>) 在 C++14 模式中可为 1，但实际上 #include <optional> 可能导致错误。

示例

#if __has_include(<optional>)
#  include <optional>
#  define have_optional 1
namespace guard { using std::optional; }
#elif __has_include(<experimental/optional>)
#  include <experimental/optional>
#  define have_optional 1
#  define experimental_optional 1
namespace guard { using std::experimental::optional; }
#else
#  define have_optional 0
#endif
 
#include <iostream>
 
int main()
{
    if (have_optional)
        std::cout << "<optional> is present.\n";
 
    int x = 42;
#if have_optional == 1
    guard::optional<int> i = x;
#else
    int* i = &x;
#endif
    std::cout << "i = " << *i << '\n';
}

<optional> is present.
i = 42

参阅