如何使用模板实现发布头文件

How to publish header files with template implementations?

本文关键字：布头文件实现何使用更新时间：2023-10-16

我们正在创建一组带有公共API的库，供不同的第三方使用。有些库是纯C的，所以很明显，它们有一个C风格的头，带有函数和结构定义以及相应的库。他们还好。

一些库是使用适度复杂的C++（针对较旧的编译器）编写的，因此我们在那里实现了某种形式的著名的pimpl习惯用法。这也可以。

另一方面，头文件的重要部分是使用大量模板化代码的C++。知道为什么模板只能在头文件中实现？但也不愿意向那些不应该看到它们的人透露太多的实现细节——我们对它们进行了大量重构，以排除尽可能多的内部细节，并且只有真正必要的部分。。。并且仍然存在大量的代码。

所以我很困惑：有没有一种更喜欢的方式来分发主要包含模板的头文件？有哪些好的做法、最佳方法、技巧和窍门？

看看C++编译器的头文件，寻找灵感。标准C++库中充满了模板，您通常会在标题中找到所有的模板代码。

话虽如此，如果特定的模板要与少量可能的类（或值）一起用作模板参数，那么您可以选择在库本身内部显式实例化模板，只在头文件中显示裸露的模板声明。

以一个更简单的C++11之前的场景为例，C++库通常只为std::basic_string<char>和std::basic_string<wchar_t>提供std::basic_string实现；并在库中留下一堆模板代码，头文件中只显示一个裸露的std::basic_string模板声明。