学习 C++ / 第 7.6 课

内部链接

7 分钟阅读

在课程 7.3 -- 局部变量中我们说过:“标识符的链接决定同名的其他声明是否引用同一对象”,并讨论了局部变量具有 no linkage。

全局变量和函数标识符可以具有 内部链接 或 外部链接。 本课介绍内部链接,外部链接见课程 7.7 -- 外部链接与变量前向声明。

具有内部链接的标识符可以在单个翻译单元中查看和使用,但无法从其他翻译单元访问。 这意味着,如果两个源文件中存在名称相同且具有内部链接的标识符,它们会被视为彼此独立,不会因重复定义而违反 ODR。

关键要点

具有内部链接的标识符可能完全不会对链接器可见;也可能对链接器可见,但会被标记为只能在特定翻译单元中使用。

相关内容

本教程将在相关课程中介绍 翻译单元,详见课程 2.10 —— 预处理器简介。

具有内部链接的全局变量

具有内部链接的全局变量有时称为 内部变量.

要让非常量全局变量具有内部链接,使用 static 关键字。

C++
#include <iostream>

static int g_x{}; // 非 const 全局变量默认具有外部链接,但可以通过 static 关键字赋予内部链接

const int g_y{ 1 }; // const globals have 内部链接 by default
constexpr int g_z{ 2 }; // constexpr globals have 内部链接 by default

int main()
{
    std::cout << g_x << ' ' << g_y << ' ' << g_z << '\n';
    return 0;
}

Const 和 constexpr 全局变量默认具有内部链接(因此不需要 static 关键字;如果使用,会被忽略)。

下面是多个文件使用内部变量的示例:

a.cpp:

C++
[[maybe_unused]] constexpr int g_x { 2 }; // 此内部链接的 g_x 只能在 a.cpp 中访问

main.cpp:

C++
#include <iostream>

static int g_x { 3 }; // 这个独立的内部链接 g_x 只能在 main.cpp 中访问

int main()
{
    std::cout << g_x << '\n'; // 使用 main.cpp 中的 g_x,输出 3

    return 0;
}

程序输出:

3

由于每个文件中的 g_x 都是内部链接,main.cpp 不知道 a.cpp 中也有名为 g_x 的变量,反之亦然。

进阶读者

上面使用的 static 关键字是存储类说明符,它同时设置名称的链接属性和存储期。 最常用的存储类说明符是 static、extern 和 mutable。“存储类说明符”这个术语主要用于技术文档。

进阶读者

C++11 标准(附录 C)解释了为什么 const 变量默认具有内部链接: “由于 const 对象可以在 C++ 中作为编译期值使用,这一特性促使程序员为每个 const 对象提供显式初始值. 这一特性允许用户把 const 对象放入会被多个编译单元包含的头文件中。”

C++ 设计者有两个目标:

  • const 对象应可用于常量表达式。要用于常量表达式,编译器必须看到定义(而不是声明),这样才能在编译期求值。
  • const 对象应能通过头文件传播。

具有外部链接的对象只能在一个翻译单元中定义,否则会违反 ODR -- 其他翻译单元必须通过前向声明访问这些对象。 如果 const 对象默认具有外部链接,它们只能在包含定义的那个翻译单元中用于常量表达式,也无法通过头文件有效传播,因为将头文件包含到多个源文件会导致 ODR 违例。n.

具有内部链接的对象可以在需要它们的每个翻译单元中各自定义,而不会违反 ODR。 这样就可以把 const 对象放在头文件中,并在任意数量的翻译单元中包含该头文件,而不会违反 ODR。 由于每个翻译单元都有定义而不是声明,因此可以确保这些常量能在该翻译单元的常量表达式中使用。

内联变量(可以具有外部链接而不违反 ODR)直到 C++17 才引入。

具有内部链接的函数

如上所述,函数标识符同样具有链接属性。 函数默认具有外部链接(下一课会介绍),但可以通过 static 关键字设置为内部链接:

add.cpp:

C++
// 此函数声明为 static,现在只能在本文件中使用
// 尝试通过函数前置声明从其他文件访问它会失败
[[maybe_unused]] static int add(int x, int y)
{
    return x + y;
}

main.cpp:

C++
#include <iostream>

int add(int x, int y); // 函数 add 的前置声明

int main()
{
    std::cout << add(3, 4) << '\n';

    return 0;
}

该程序无法链接,因为函数 add 无法在 add.cpp。

单一定义规则与内部链接

在课程 2.7——前置声明与定义中,我们提到单一定义规则规定:一个对象或函数在一个文件或程序中不能有多个定义。

不过需要注意,在不同文件中定义的内部对象(和函数)会被视为独立实体(即使名称和类型相同),因此不违反单一定义规则。每个内部对象都只有一个定义。

static 与未命名命名空间

在现代 C++ 中,使用 使用 static 关键字为标识符提供内部链接的做法逐渐不再推荐。未命名命名空间可以为更广泛的标识符(例如类型标识符)提供内部链接,更适合为多个标识符提供内部链接。

本教程将在课程 7.14 —— 未命名命名空间与内联命名空间 中介绍。

为什么要让标识符具有内部链接?

通常有两个理由让标识符具有内部链接:

  • 希望确保某个标识符不能被其他文件访问。 这可以是我们不希望被随意修改的全局变量,也可以是不希望被外部调用的辅助函数。
  • 为了严格避免名称冲突。 由于具有内部链接的标识符不会暴露给链接器,它们只可能与同一翻译单元中的名称冲突,不会与整个程序其他文件中的名称冲突。

许多现代开发指南建议,为所有不打算让其他文件使用的变量和函数设置内部链接。 如果你能坚持遵守,这是一个很好的建议。

目前至少建议采用较轻量的做法:对于有明确理由禁止其他文件访问的标识符,为其设置内部链接。

最佳实践

当你有明确理由禁止其他文件访问某个标识符时,请为它设置内部链接。

可以考虑让所有不希望被其他文件访问的标识符都具有内部链接(可使用未命名命名空间)。

快速总结

C++
// 内部链接全局变量的定义:
static int g_x;          // 定义未初始化的内部链接全局变量(默认进行零初始化)
static int g_x{ 1 };     // 定义已初始化的内部链接全局变量

const int g_y { 2 };     // 定义已初始化的内部链接全局 const 变量
constexpr int g_y { 3 }; // 定义已初始化的内部链接全局 constexpr 变量

// 内部链接函数的定义:
static int foo() {};     // 定义内部链接函数

完整总结见课程 7.12 -- 作用域、存储期与链接属性总结。

最后更新