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

Question

我正在围绕一个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.h和clib.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)

这是个好主意还是可行的？为什么没人这么做？

Answer 1

，这是一个好主意，还是可能做到？

不，这是行不通的，因为C库--由于明显的原因--没有在名称空间中定义函数等。

为什么没有人这么做呢？

因为它不管用。

如果您放弃了拥有一个只有头的包装库的愿望，那么您可以避免“泄漏”C头，因为您只能将它包含在包装器库的一个翻译单元中。

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