Qt 中的 d-pointer 与 p-pointer小结

Qt 中的 d-pointer 与 p-pointer：

PIMPL 惯用法解析
在 Qt 库中，尤其是在其核心类和模块中，广泛使用了 PIMPL (Pointer to IMPLementation，指向实现的指针) 的编程惯用法。这种模式通过一对指针来实现：d-pointer (d_ptr) 和 p-pointer (q_ptr)。
1. PIMPL (Pointer to IMPLementation) 惯用法
目的： 将类的公共接口与其私有实现细节分离开来。
主要优点：
（1）减少编译依赖： 公共类的头文件只需要包含私有实现类的前向声明，而无需包含其完整的定义以及私有实现所依赖的其他头文件。当私有实现发生变化时，只需要重新编译私有实现文件，而包含公共类头文件的其他源文件无需重新编译，显著减少了大型项目的编译时间。
（2）隐藏实现细节： 提高了类的封装性，用户只能看到公共接口，无法直接访问私有成员。
（3）ABI 兼容性： 在不改变公共类布局（即其成员变量的内存偏移和大小）的情况下，可以修改私有实现类的内部结构。这对于构建二进制兼容的库非常重要，允许库的维护者在不强制用户重新编译使用该库的所有代码的情况下发布更新。
2. d-pointer (数据指针)
定义： 通常是公共类中的一个指针成员（在 Qt 中通常命名为 d_ptr），它指向一个包含所有私有成员和私有函数的单独的类（私有实现类）。
作用： 公共类通过 d_ptr 来访问和调用私有实现类中的实际逻辑和数据。它是从公共接口到私有实现的桥梁。
声明： 在 Qt 中，使用 Q_DECLARE_PRIVATE(ClassName) 宏在公共类的头文件中声明 d-pointer，并完成私有实现类的必要前向声明。
示例 (简化概念)：

    // MyClass.h (公共接口)
    class MyClassPrivate; // 前向声明私有实现类

    class MyClass {
        // ... 公共成员和函数 ...

    private:
        MyClassPrivate* d_ptr; // d-pointer 指向私有实现
        Q_DECLARE_PRIVATE(MyClass) // Qt 宏，声明 d-pointer
    };

    // MyClass_p.h (私有实现 - 通常不对外公开)
    #include "MyClass.h" // 需要包含公共类头文件
    class MyClassPrivate {
        // ... 私有数据成员 ...
        // ... 私有实现函数 ...

        MyClass* q_ptr; // p-pointer 指回公共类
        Q_DECLARE_PUBLIC(MyClass) // Qt 宏，声明 q_ptr
    };

    // MyClass.cpp (实现文件)
    #include "MyClass_p.h" // 包含私有实现头文件

    // ... MyClass 公共函数的实现，通过 d_ptr 访问私有实现 ...

3. p-pointer (公共指针)
定义： 通常是私有实现类中的一个指针成员（在 Qt 中通常命名为 q_ptr），它指回创建该私有实现对象的那个公共类实例。
作用： 允许私有实现类中的代码方便地调用公共类中的公共（或保护）函数，或者访问公共（或保护）成员。它是从私有实现到公共接口的桥梁。
声明： 在 Qt 中，使用 Q_DECLARE_PUBLIC(ClassName) 宏在私有实现类的头文件中声明 p-pointer。
示例 (承接上文，简化概念)：

    // MyClass.cpp (实现文件)
    #include "MyClass_p.h"

    // 私有实现函数示例
    void MyClassPrivate::somePrivateFunction() {
        Q_UNUSED(d_ptr); // 在私有实现中很少直接用 d_ptr

        // 通过 q_ptr 调用公共类的方法
        q_ptr->somePublicMethod();
    }

    // ... 公共函数的实现 ...

d-pointer 与 p-pointer 的核心区别与联系