C++命名空间在多文件编程中的具体用法

《C++命名空间》一节讲到，C++ 引入命名空间是为了避免合作开发项目时产生命名冲突，例如：

#include <iostream>
namespace Li {  //小李的变量定义
    class Student {
    public:
        void display(){
            std::cout << "Li::display" << std::endl;
        }
    };
}
namespace Han {  //小韩的变量定义
    class Student {
    public:
        void display() {
            std::cout << "Han::display" << std::endl;
        }
    };
}
int main() {
    Li::Student stu1;
    stu1.display();

    Han::Student stu2;
    stu2.display();
    return 0;
}

程序执行结果为：

如上所示，小李与小韩各自定义了以自己姓氏为名的命名空间，此时再将他们各自定义的 Student 类放在一起编译就不会有任何问题。

那么当进行多文件编程时，命名空间又该如何使用呢？一个项目的多个文件中可以使用同一个命名空间吗？接下来就对这些疑问做一一解答。

《C++多文件编程是什么》一节讲到，当进行多文件编程时，通常是将声明部分（例如变量、函数和类等）划分到 .h 文件中，将实现部分划分到 .cpp 文件中。在此基础上，如果要给变量、函数或者类指定命名空间，则该命令空间应至少包含它们的声明部分。所以当进行多文件编程时，命名空间常位于 .h 头文件中。

举个例子，如下是对之前程序做的合理划分：

//student_li.h
#ifndef _STUDENT_LI_H
#define _STUDENT_LI_H
namespace Li {  //小李的变量定义
    class Student {
    public:
        void display();
    };
}
#endif

//student_li.cpp
#include "student_li.h"
#include <iostream>
void Li::Student::display() {
    std::cout << "Li::display" << std::endl;
}

//student_han.h
#ifndef _STUDENT_HAN_H
#define _STUDENT_HAN_H
namespace Han {  //小韩的变量定义
    class Student {
    public:
        void display();
    };
}
#endif

//student_han.cpp
#include "student_han.h"
#include <iostream>
void Han::Student::display() {
    std::cout << "han::display" << std::endl;
}

//main.cpp
#include <iostream>
#include "student_han.h"
#include "student_li.h"
int main() {
    Li::Student stu1;
    stu1.display();
    Han::Student stu2;
    stu2.display();
    return 0;
}

项目执行结果为：

注意，当类的声明位于指定的命名空间中时，如果要在类的外部实现其成员方法，需同时注明所在命名空间名和类名（例如本项目中的 Li::Student::display() ）。

上面的程序示例中，不同的头文件中使用的是不同的命名空间，除此之外，不同头文件中也可以使用名称相同的命名空间，但前提是位于该命名空间中的成员必须保证互不相同。

举个例子：

//demo1.h
#ifndef _DEMO1_H
#define _DEMO1_H
#include<iostream>
namespace demo {
    void display() {
        std::cout << "demo1::display" << std::endl;
    }
    int num=20;
}
#endif

//demo2.h
#ifndef _DEMO2_H
#define _DEMO2_H
#include <iostream>
namespace demo {
    void display(int a) {
        std::cout << "demo2::display" << std::endl;
    }
    //int num; 因为 demo1.h 中已经声明有同名的变量，取消注释会造成重定义错误
}
#endif

//main.cpp
#include <iostream>
#include "demo1.h"
#include "demo2.h"
int main() {
    demo::display();
    demo::display(2);
    std::cout << demo::num << std::endl;
    return 0;
}

项目执行结果为：

注意，本例中 display() 函数的实现也位于 .h 文件中，仅仅是为了演示方便，读者可自行将该函数的声明和定义进行合理划分。

可以看到，demo1.h 和 demo2.h 文件中都定义有 demo 命名空间，当这 2 个头文件被引入到 main.cpp 文件中时，意味着 demo 空间中同时包含 display()、display(int n) 以及 num 这 3 个成员。也就是说，分散在不同文件中的同名命名空间会合并为一个。

再次强调，虽然同一项目的不同文件中可以定义相同的命名空间，但必须保证空间中的成员互不相同，否则编译器会报“重定义”错误。注意，这里的 display() 和 display(int n) 并不会造成重定义，它们互为重载函数。