C++ 中隐藏类实现细节Pimpl idiom

本文主要是介绍C++ 中隐藏类实现细节Pimpl idiom，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Pimpl idiom（Pointer to Implementation idiom）是一种在 C++ 中用于隐藏类实现细节的技术。它的核心思想是将类的实现细节封装在一个私有的数据结构中，并通过一个指针来访问这个私有数据结构。这样做的好处是可以减少头文件的大小和依赖，从而加快编译速度，并且可以更容易地修改类的内部实现而不影响到客户端代码。Pimpl idiom 是一种非常有用的技巧，特别是在大型项目中，它可以减少编译时间，提高代码的可维护性。通过将实现细节封装在私有数据类中，可以轻松地修改内部实现而不影响到客户端代码。在实际应用中，可以结合 Qt 提供的宏来实现更为优雅的 Pimpl idiom。Q_DECLARE_PRIVATE 和 Q_DECLARE_PUBLIC 是 Qt 中用于实现私有数据成员的宏。通过这种方式，还可以避免编译时的依赖问题，尤其是在头文件中包含大量实现细节时非常有用。

Pimpl Idiom 的优点

减少编译依赖：通过将实现细节封装在一个私有类中，可以减少头文件的大小和依赖，从而加快编译速度。
隐藏实现细节：对外部用户隐藏类的内部实现，便于在不影响外部接口的情况下修改内部实现。
便于版本控制：当需要进行大的重构或实现改变时，不会影响到使用该类的客户端代码。

Pimpl Idiom 的基本结构

一个典型的使用 Pimpl idiom 的类通常包含以下组成部分：

公共类：这是客户端看到的类，它包含公共接口。
私有数据类：这个类包含了实际的数据成员和实现细节，通常只在实现文件中可见。
指针成员：公共类中包含一个指向私有数据类的指针成员，用于访问私有数据。

Q_DECLARE_PRIVATE

Q_DECLARE_PRIVATE 宏用于声明一个私有数据成员，该成员通常是一个指向私有数据结构的指针。它定义了一个名为 d_func 的成员函数，该函数返回一个指向私有数据的指针。这个宏还定义了 d_ptr 成员变量，用于存储指向私有数据的指针。

示例：

class MyClassPrivate;  // 声明私有数据结构class MyClass
{Q_DECLARE_PRIVATE(MyClass)  // 使用 Q_DECLARE_PRIVATE 宏public:MyClass();~MyClass();void doSomething();private:Q_DISABLE_COPY(MyClass)  // 禁止拷贝构造和赋值操作
};// 实现部分
class MyClassPrivate
{
public:int someData;
};MyClass::MyClass()
{d_ptr = new MyClassPrivate();  // 初始化私有数据
}MyClass::~MyClass()
{delete d_ptr;  // 清理私有数据
}void MyClass::doSomething()
{Q_D(MyClass);  // 使用 Q_D 宏获取私有数据指针d->someData = 42;  // 修改私有数据
}

Q_DECLARE_PUBLIC

Q_DECLARE_PUBLIC 宏用于私有数据类中，它定义了一个名为 q_func 的成员函数，该函数返回指向公共类的指针。这个宏主要用于在私有数据类中访问公共类的成员。

示例：

class MyClass;class MyClassPrivate
{Q_DECLARE_PUBLIC(MyClass)  // 使用 Q_DECLARE_PUBLIC 宏public:int someData;void setSomeData(int data){q_func()->doSomethingElse();  // 访问公共类的成员someData = data;}
};// 公共类
class MyClass
{Q_DECLARE_PRIVATE(MyClass)  // 使用 Q_DECLARE_PRIVATE 宏public:MyClass();~MyClass();void doSomething();void doSomethingElse();private:Q_DISABLE_COPY(MyClass)  // 禁止拷贝构造和赋值操作
};// 实现部分
MyClass::MyClass()
{d_ptr = new MyClassPrivate();  // 初始化私有数据
}MyClass::~MyClass()
{delete d_ptr;  // 清理私有数据
}void MyClass::doSomething()
{Q_D(MyClass);  // 使用 Q_D 宏获取私有数据指针d->setSomeData(42);  // 调用私有数据类的成员函数
}void MyClass::doSomethingElse()
{// ...
}