c++ - 仅在 C++ 的 API 内部使用时从外部隐藏类

Question

在像 Java 这样的语言中，您可以在不使用修饰符的情况下声明一个类，这样它就只会在同一个包内可见。我需要在 C++ 中做类似的事情。我正在尝试创建一个 API，它将成为一个用于其他应用程序的库。问后this关于程序员 Stackexchange 的问题，我决定使用某种句柄，它只是传递给 API 函数的无符号整数，然后将其传递给一个类，该类将在某种表格中查找并返回指向句柄所代表的对象的指针，返回给函数。然后将允许 API 函数对指针进行操作，但公众永远无法访问该指针。

问题是，我希望处理句柄的类对公众不可见(即使公众没有包含句柄的类的实例)，因为它只在API函数。另外，我希望这个句柄类是一个模板(只需要编译 API)，因为我很可能有代表不同类型类的句柄(虽然我可能会逃避一个包含空指针的表，但它似乎是有点不安全)。我无法将类隐藏在 .cpp 文件中，因为组成 API 的多个 .cpp 文件都需要它。

此外，我正在考虑在任何具有公共(public)函数的类中使用 pimpl 习惯用法，这样，如果它们中有任何私有(private)函数需要一个与我的某个类相关的参数对公众隐藏，一个头文件包括API 用户无需将隐藏类包含在 API 库中即可编译程序。

那么，将仅在其他类(分布在多个 .h 和 .cpp 文件中)内部的类从外部世界隐藏到 API 自身中的最佳方法是什么？

Answer 1

您确实可以使用 PIMPL 习语；只需编写该类型的前向声明并使用指向它的(智能)指针作为成员。那应该处理头文件。

对于实现，只需有一个单独的头文件，该文件包含在库的实现中，但不包含在接口(interface)的任何部分中。示例:

// Interface.h

class Secret;

class Hi {
public:
    Hi();
    ~Hi();

    void stuff();

private:
    Secret* secret;
};

---

// Implementation.cpp

#include "Secret.h"
#include "Interface.h"

Hi::Hi() : secret(new Secret) { }
Hi::~Hi() { delete secret; }

void Hi::stuff() { secret->stuff(); }

---

// Secret.h

class Secret {
public:
    int data;
    void stuff() { ... }
};