在课程 7.3 -- 局部变量中我们说过:“标识符的链接决定同名的其他声明是否引用同一对象”,并讨论了局部变量具有 no linkage。
全局变量和函数标识符可以具有 内部链接 或 外部链接。 本课介绍内部链接,外部链接见课程 7.7 -- 外部链接与变量前向声明。
具有内部链接的标识符可以在单个翻译单元中查看和使用,但无法从其他翻译单元访问。 这意味着,如果两个源文件中存在名称相同且具有内部链接的标识符,它们会被视为彼此独立,不会因重复定义而违反 ODR。
关键要点
具有内部链接的标识符可能完全不会对链接器可见;也可能对链接器可见,但会被标记为只能在特定翻译单元中使用。
相关内容
本教程将在相关课程中介绍 翻译单元,详见课程 2.10 —— 预处理器简介。
具有内部链接的全局变量
具有内部链接的全局变量有时称为 内部变量.
要让非常量全局变量具有内部链接,使用 static 关键字。
#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:
[[maybe_unused]] constexpr int g_x { 2 }; // 此内部链接的 g_x 只能在 a.cpp 中访问
main.cpp:
#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:
// 此函数声明为 static,现在只能在本文件中使用
// 尝试通过函数前置声明从其他文件访问它会失败
[[maybe_unused]] static int add(int x, int y)
{
return x + y;
}
main.cpp:
#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 —— 未命名命名空间与内联命名空间 中介绍。
为什么要让标识符具有内部链接?
通常有两个理由让标识符具有内部链接:
- 希望确保某个标识符不能被其他文件访问。 这可以是我们不希望被随意修改的全局变量,也可以是不希望被外部调用的辅助函数。
- 为了严格避免名称冲突。 由于具有内部链接的标识符不会暴露给链接器,它们只可能与同一翻译单元中的名称冲突,不会与整个程序其他文件中的名称冲突。
许多现代开发指南建议,为所有不打算让其他文件使用的变量和函数设置内部链接。 如果你能坚持遵守,这是一个很好的建议。
目前至少建议采用较轻量的做法:对于有明确理由禁止其他文件访问的标识符,为其设置内部链接。
最佳实践
当你有明确理由禁止其他文件访问某个标识符时,请为它设置内部链接。
可以考虑让所有不希望被其他文件访问的标识符都具有内部链接(可使用未命名命名空间)。
快速总结
// 内部链接全局变量的定义:
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 -- 作用域、存储期与链接属性总结。