在 C++ 库中隐藏 C 头文件中的函数

Question

我正在为我的一些朋友开发一个小型游戏引擎，并且我正在使用 OpenGL（以及 GLFW 和 GLEW 以及所有这些东西）进行渲染。您可能知道，OpenGL 是一个 C 库，因此不包含类。现在，我不希望我的朋友（或我自己）看到来自 glfw3.h 和 glew.h 的所有 gobbledygook，我想知道是否有一种简单的方法可以向用户隐藏此类内容。

我知道在很多情况下，在这种情况下可能会尝试 pimpl，但问题是，我所拥有的只是函数。我可以将它们全部放在一个静态类或命名空间中，然后由必要的类包含，但这仍然不会对用户隐藏这些功能。我唯一想到的就是函数指针的奇怪和麻烦，但我会经常使用这些函数，以至于它会减慢开发速度。

最后，我想如果像glVertexAttribPointer 这样的可怕东西是可见的，那也不会很糟糕，但这只是我想要的东西。提前致谢。

Answer 1

您是否从来没有想过要真正查看glfw3.h 并查看GLFWwindow 是如何定义的？

/*! @brief Opaque window object.
 *
 *  Opaque window object.
 *
 *  @see @ref window_object
 *
 *  @since Added in version 3.0.
 *
 *  @ingroup window
 */
typedef struct GLFWwindow GLFWwindow;

你不能在 markdown 代码部分强调单词太糟糕了。里面有一个重要的小词：不透明

GLFWwindow 已作为前向结构声明写入标头。这意味着你只能创建它的指针变量。

所以在你的类中，如果你只需要一个指针，在定义你的类之前添加一个相同的前向声明，这是完全可以接受的模式，即

typedef struct GLFWwindow GLFWwindow;

class whatever {
    /* ... */
    GLFWwindow *wnd;
    /* ... */
};

然后您可以在 C++ 编译单元源文件中包含 glfw3.h。

---

但是你为什么还要关心呢？ 据你所知，使用你的库的人可能会故意包含 OpenGL 头文件。您包括 GLFW，而 GLFW 包括 OpenGL 标头。因此，无论谁要使用您的库，都将依赖于嵌套类型定义。

努力“隐藏”事物很少有什么好处。只要你不污染命名空间就接受它。

唉，划分的原因有一个好：加快编译时间：包含的头文件越少越好。