在命名空间中包含实现文件以避免名称冲突

时间:2021-01-28 10:41:14

标签: c++ namespaces include

我正在围绕 C 库制作 C++ 包装器。假设库(我们称之为 Clib)定义了一个这样的函数:

// clib.h
const char* clib_foo(clib_obj_t* obj);

在我的包装器中,我有以下内容:

// clibpp.h
#include <clib.h>

namespace clib {
    std::string_view foo(const clib::obj_t& obj) {
        return clib_foo(obj.raw());
    };
}

// symbols from both clib.h and clibpp.h visible

现在,我的包装器只是标题。因此,当有人包含 clibpp.h 时,他们会看到来自 clibpp.hclib.h 的符号。我想避免这种情况。我的想法是在 clib.h 标头的命名空间内包含 clibpp.h 标头以隐藏所有符号。

// clibpp.h
namespace clib {
    namespace detail {
        #include <clib.h>
    }
    std::string_view foo(const clib::obj_t& obj) {
        return detail::clib_foo(obj.raw());
    };
}

// symbols from only clibpp.h visible (apart from preprocessor definitions)

这是个好主意还是可行?为什么似乎没有人这样做?

1 个答案:

答案 0 :(得分:2)

<块引用>

这是个好主意还是可行?

不,这是行不通的,因为 C 库 - 出于显而易见的原因 - 没有在该命名空间内定义函数等。

<块引用>

为什么似乎没有人这样做?

因为它不起作用。


如果您不想拥有仅包含头文件的包装库,那么您可以避免“泄漏”C 头文件,因为您只能将它包含在包装库的翻译单元中。

请注意,这仍然不能解决名称冲突的所有问题,因为一个定义规则适用于跨翻译单元边界。如果您与 C 库链接,则该库的外部名称不能被其他任何东西使用。隐藏 C 标头确实可以防止宏污染。