【C++入门】命名空间

前言

我们都知道一个大型的项目往往需要许多人协同操作，而动辄几万行的代码量中经常会出现不同人写的代码因为变量命名相同这类的事情而导致程序崩溃。那么为何不把每个人写的代码分开？比如把代码存进一个独立的保险库中。而这种保险库我们称他为命名空间。

目的

使用命名空间的目的是对标识符的名称进行本地化， 以避免命名冲突或名字污染，namespace关键字的出现就是针对这种问题的。

定义

定义命名空间，需要使用到namespace关键字，后面跟命名空间的名字，然后接一对{}即可，{}

中即为命名空间的成员。如下面的代码

bit是命名空间的名字，一般开发中是用项目名字做命名空间名。

// 1. 正常的命名空间定义

namespace bit
{
 int rand = 10;
 int Add(int left, int right)
 {
 return left + right;
 }

在命名空间中我们可以定义变量/函数/类型

//2. 命名空间可以嵌套

在命名空间中我们可以嵌套定义一个命名空间，如：

// test.cpp
namespace N1
{
int a;
int b;
int Add(int left, int right)
 {
     return left + right;
 }
namespace N2
 {
     int c;
     int d;
     int Sub(int left, int right)
     {
         return left - right;
     }
 }
}

//3. 同一个工程中允许存在多个相同名称的命名空间 , 编译器最后会合成同一个命名空间中。

// test.h
namespace N1
{
int Mul(int left, int right)
 {
     return left * right;
 }
}

// ps ：一个工程中的 test.h 和上面 test.cpp 中两个 N1 会被合并成一个

注意：一个命名空间就定义了一个新的作用域，命名空间中的所有内容都局限于该命名空间中

命名空间使用

namespace bit
{
 // 命名空间中可以定义变量/函数/类型
 int a = 0;
 int b = 1;
 int Add(int left, int right)
 {
 return left + right;
 }
 struct Node
 {
 struct Node* next;
 int val;
 };
}
int main()
{
 // 编译报错：error C2065: “a”: 未声明的标识符
 printf("%d\n", a);
return 0;
}

命名空间中成员该如何使用呢？命名空间有三种使用方法

1.加命名空间名称及作用域限定符 ::

int main()
{
    printf("%d\n", N::a);
    return 0;    
}

2.使用using将命名空间中某个成员引入

using N::b;
int main()
{
    printf("%d\n", N::a);
    printf("%d\n", b);
    return 0;    
}

3.使用using namespace 命名空间名称 引入

using namespce N;
int main()
{
    printf("%d\n", N::a);
    printf("%d\n", b);
    Add(10, 20);
    return 0;    
}

命名空间的使用优势

1. 防止命名冲突：不同库或项目部分的功能可以使用相同的名字而不会发生冲突，例如std命名空间中vector和自定义的vector类。

2. 组织代码：命名空间可以帮助逻辑上组织相关的代码，使结构更清晰。

3. 版本控制：可以使用命名空间来区分代码库的不同版本。

使用建议

1. 合理划分：为库或大型项目的逻辑部分创建命名空间，如工具类、辅助功能、数据模型等，每个命名空间应包含逻辑上相关联的功能。

2. 避免使用using namespace：虽然在文件顶部使用using namespace std;可以减少代码中的std::前缀，但在大型项目中，这样做可能会引起命名冲突和理解上的困难。最佳实践是在需要使用特定命名空间中的几个对象时，使用具体的using声明，如using std::vector;。

3. 不要在头文件中使用using namespace：这样做会强迫包含该头文件的所有源文件都导入该命名空间，可能会在不相关的代码区域引入命名冲突。头文件中应尽量只使用命名空间来限定声明和定义，例如std::vector<int> myVector;。

4. 嵌套命名空间：C++17引入了嵌套命名空间的定义简写，如namespace A::B::C，可以用来简化代码结构，但应谨慎使用以保持代码清晰。

5. 匿名命名空间：在源文件中使用匿名命名空间（通过namespace关键字后不跟名称）可以保护该文件内全局变量和函数不被其他文件访问，相当于定义了静态文件作用域。

6. 适时使用别名：为长命名空间或常用命名空间设置别名可以简化代码，如namespace fs = std::filesystem;，这样可以使代码更加简洁易读。

总之，正确地使用命名空间是写出清晰、可维护和健壮的C++代码的关键因素之一。