隐藏库中 C 标头C++函数

Hide functions from C header in C++ library

本文关键字:C++ 函数 标头 隐藏      更新时间:2023-10-16

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

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

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

你有没有想过,真正研究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;

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

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

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

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

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


但你为什么还要关心呢?据您所知,无论谁要使用您的库,都可能有意包含 OpenGL 标头。你包括GLFW,GLFW包括OpenGL标头。因此,无论谁要使用您的库,都将取决于嵌套类型定义。

太努力地"隐藏"事情很少会带来好事。只要你不污染命名空间,就接受它。

唉,划分有一个很好的理由:加快编译时间:要包含的标头越少越好。