Qt Q_Q和Q_D宏

Sakuya__

于 2024-09-16 14:47:54 发布

阅读量586

点赞数 15

分类专栏： QT 文章标签： c++ Qt

本文链接：https://blog.csdn.net/Sakuya__/article/details/142280464

版权

QT 专栏收录该内容

28 篇文章 22 订阅

订阅专栏

最近在一些Qt的开源项目中看到有使用到Q_Q和Q_D宏，使用后就可以使用q和d两个指针访问其他类里面的成员变量。好奇这两个宏的作用是什么，就去学习了一番，这里记录一下，防止以后忘记。

在最前面，先简单说一下这两个宏是做什么的。它们主要用于实现一种称为d-pointer（或pimpl）的设计模式，这种模式可以隐藏类的实现细节，提高编译效率和二进制兼容性。Q_D宏的主要作用是简化私有数据的访问，Q_Q宏用于在私有实现类中访问公共类的指针。

Q_D宏

Q_D宏的使用场景是，当我有一个类 MyClass 需要提供给其他地方使用。但同时，我们有一些数据成员变量和函数是不希望使用者直接看到和修改的，于是我们就可以创建一个私有实现类 MyClassPrivate，里面存放这些我们希望隐藏的成员变量和函数。这时候，我们想在 MyClass 中调用 MyClassPrivate 类里的比变量或者函数，就可以使用 Q_D 宏来方便的访问 MyClassPrivate 中的变量和函数。通过这种方式，可以有效地隐藏实现细节，保护数据成员不被外部直接访问和修改，同时保持类接口的简洁和清晰。

MyClass_p.h

在 MyClassPrivate 类中声明了一个公共类的访问宏：Q_DECLARE_PUBLIC(MyClass)，使得MyClassPrivate可以访问MyClass类中的公共成员。

#ifndef MYCLASS_P_H
#define MYCLASS_P_H

class MyClass;

class MyClassPrivate {
    Q_DECLARE_PUBLIC(MyClass) // 声明公共类的访问宏
public:
    MyClassPrivate();
    ~MyClassPrivate();

    int m_value;

private:
    MyClass *q_ptr; // 指向公共类的指针
};

#endif // MYCLASS_P_H

MyClass.h

在MyClass类中声明了一个私有类的访问宏：Q_DECLARE_PRIVATE(MyClass)，使得MyClass可以访问MyClassPrivate类中的私有成员。

#ifndef MYCLASS_H
#define MYCLASS_H

#include <QSharedDataPointer>

class MyClassPrivate;

class MyClass {
    Q_DECLARE_PRIVATE(MyClass) // 声明私有类的访问宏
public:
    MyClass();
    ~MyClass();

    void setValue(int value);
    int value() const;

private:
    QSharedDataPointer<MyClassPrivate> d_ptr; // 私有数据指针
};

#endif // MYCLASS_H

MyClass.cpp

MyClass_p.h 和 MyClass.h 的实现都写在 MyClass.cpp 中。在 MyClass 的成员函数中使用Q_D(MyClass)这个宏，可以方便地使用 d 指针获取指向 MyClassPrivate 的指针，从而访问私有数据。

#include "MyClass.h"
#include "MyClass_p.h"

MyClassPrivate::MyClassPrivate()
 : m_value(0),
   q_ptr(nullptr)
{
}

MyClassPrivate::~MyClassPrivate()
{
}


MyClass::MyClass()
 : d_ptr(new MyClassPrivate)
{
    Q_D(MyClass);
    d->q_ptr = this; // 初始化私有类中的q_ptr
}

MyClass::~MyClass()
{
}

void MyClass::setValue(int value)
{
    Q_D(MyClass);
    d->m_value = value; // 使用Q_D宏访问私有数据
}

int MyClass::value() const
{
    Q_D(const MyClass);
    return d->m_value; // 使用Q_D宏访问私有数据
}

在这个示例中，MyClass 通过 Q_D(MyClass) 宏获取到 MyClassPrivate 的指针 d，从而可以访问 MyClassPrivate 中的私有函数和数据成员。

Q_Q宏

上面的Q_D宏用于访问类的私有数据，那么想在私有实现类中访问公共类的指针该怎么做呢，这时候就可以使用Q_Q宏。它通常与Q_DECLARE_PUBLIC宏配合使用，使得私有实现类可以通过 q 指针方便地访问公共类的成员。

// MyClass_p.h
class MyClass;
class MyClassPrivate {
    Q_DECLARE_PUBLIC(MyClass)
public:
    void privateFunction();
private:
    MyClass *q_ptr;
};

// MyClass.cpp
void MyClassPrivate::privateFunction() {
    Q_Q(MyClass);
    q->publicFunction();
}