c++ - C++ 公共(public) API 的最佳实践是什么？

Question

C++ 公共(public) API 的最佳实践是什么？

我正在处理一个具有多个 namespace 的 C++ 项目，每个 namespace 都有多个对象。有些对象具有相同的名称，但位于不同的 namespace 中。目前，每个对象都有自己的 .cpp 文件和 .h 文件。我不确定如何表达这个...创建第二个 .h 文件以仅公开公共(public) API 是否合适？它们应该是每个命名空间或每个对象或其他范围的 .h 文件吗？为 C++ 库创建公共(public) API 的最佳实践是什么？

感谢您的帮助，陈子

Answer 1

有时在每个 .cpp 和 .h 文件对中都有一个类并将 namespace 层次结构作为目录层次结构会很方便。
例如，如果你有这个类:

namespace stuff {
  namespace important {
    class SecretPassword 
    {
       ...
    };
  }
}

那么它将在两个文件中:

/stuff/important/SecretPassword.cpp
/stuff/important/SecretPassword.h

另一种可能的布局可能是:

/src/stuff/important/SecretPassword.cpp
/include/stuff/important/SecretPassword.h