多重定义错误,包括带有来自多个源的内联代码的c ++头文件

我有一个包含类的c ++头文件.我想在几个项目中使用这个类,我不想为它创建一个单独的库,所以我将两个方法声明和定义放在头文件中:

// example.h
#ifndef EXAMPLE_H_
#define EXAMPLE_H_
namespace test_ns{

class TestClass{
public:
    void testMethod();
};

void TestClass::testMethod(){
    // some code here...
}

} // end namespace test_ns
#endif

如果在同一个项目中我从多个cpp文件中包含这个头文件,我会收到一条错误说" multiple definition of test_ns::TestClass::testMethod()",而如果我将方法定义放在类体中,则不会发生这种情况:

// example.h
#ifndef EXAMPLE_H_
#define EXAMPLE_H_
namespace test_ns{

class TestClass{
public:
    void testMethod(){
        // some code here...
    }
};

} // end namespace test_ns
#endif

由于类是在命名空间内定义的,这两种形式不应该是等价的吗？为什么在第一种情况下认为方法定义了两次？

这些并不等同.给出的第二个示例在方法上有一个隐式的"内联"修饰符,因此编译器将自己协调多个定义(如果不可内联,则很可能与方法的内部链接相关).

第一个示例不是内联的,因此如果此标头包含在多个转换单元中,那么您将有多个定义和链接器错误.

此外,应始终保护标题以防止同一翻译单元中出现多个定义错误.这应该将您的标题转换为:

#ifndef EXAMPLE_H
#define EXAMPLE_H

//define your class here

#endif

类体内部被编译器认为是内联的.如果您在body之外实现,但仍然在header中,则必须将该方法明确标记为"inline".

namespace test_ns{

class TestClass{
public:
    inline void testMethod();
};

void TestClass::testMethod(){
    // some code here...
}

} // end namespace test_ns

编辑

对于我自己来说,通过认识到编译器看不到像头文件这样的东西,通常有助于解决这些类型的编译问题.头文件是预处理的,编译器只看到一个包含每个(递归)包含文件中每一行的大文件.通常,这些递归包含的起点是正在编译的cpp源文件.在我们公司,即使是一个看起来很小的cpp文件也可以作为300000行怪物呈现给编译器.

因此,当一个未声明为内联的方法在头文件中实现时,编译器最终可能会在预处理文件中看到void TestClass :: testMethod(){...}几十次.现在您可以看到这没有意义,与在一个源文件中多次复制/粘贴它时获得的效果相同.即使你成功只在每个编译单元中使用一次,通过某种形式的条件编译(例如使用包含括号),链接器仍然会发现此方法的符号位于多个编译单元(目标文件)中.