Back to Qt.io
Contact Us Blog Download Qt

QPointer Class

template <typename T> class QPointer

QPointer 类是一个模板类，提供指向QObject 的受保护指针。更多

头文件： #include <QPointer>
CMake： find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake： QT += core

该类可等价比较。

该类可与 QPointer<X>、X* 和 std::nullptr_t 进行等价比较。

其中 X 和 T 是兼容类型，这意味着它们要么是相同的（除了 cv-qualifiers 之外），要么一个是另一个的基类型。

公共函数

QPointer()
(since 6.6) QPointer(QPointer<X> &&other)
QPointer(T *p)
(since 6.6) QPointer(const QPointer<X> &other)
QPointer(std::nullptr_t)
~QPointer()
void clear()
T *data() const
(since 6.0) T *get() const
bool isNull() const
void swap(QPointer<T> &other)
T *operator T *() const
T &operator*() const
T *operator->() const
(since 6.6.1) QPointer<T> &operator=(QPointer<X> &&other)
QPointer<T> &operator=(T *p)
(since 6.6) QPointer<T> &operator=(const QPointer<X> &other)
bool operator!=(X *const &lhs, const QPointer<T> &rhs)
bool operator!=(const QPointer<T> &lhs, X *const &rhs)
bool operator!=(const QPointer<T> &lhs, const QPointer<X> &rhs)
bool operator!=(const QPointer<T> &lhs, const std::nullptr_t &rhs)
bool operator!=(const std::nullptr_t &lhs, const QPointer<T> &rhs)
bool operator==(X *const &lhs, const QPointer<T> &rhs)
bool operator==(const QPointer<T> &lhs, X *const &rhs)
bool operator==(const QPointer<T> &lhs, const QPointer<X> &rhs)
bool operator==(const QPointer<T> &lhs, const std::nullptr_t &rhs)
bool operator==(const std::nullptr_t &lhs, const QPointer<T> &rhs)

详细说明

守护指针（QPointer<T>）的行为与普通 C++ 指针T * 类似，只是当被引用对象被销毁时，它将被自动清除（与普通 C++ 指针不同，在这种情况下，它将成为 "悬空指针"）。T 必须是QObject 的子类。

每当需要存储指向QObject 的指针时，守护指针就会派上用场，因为该指针为他人所有，因此可能会在你仍持有其引用时被销毁。您可以安全地测试指针的有效性。

请注意，Qt 5 在使用 QPointer 时引入了一个轻微的行为变化。

  • 在QWidget （或QWidget 的子类）上使用 QPointer 时，以前 QPointer 会被QWidget 析构函数清除。现在，QPointer 将由QObject 析构函数清除（因为QWeakPointer 对象就是在这个时候被清除的）。在QWidget 析构函数销毁被跟踪部件的子部件之前，任何跟踪部件的 QPointer 都不会被清除。

Qt XML 还提供了QSharedPointer ，这是一个引用计数共享指针对象的实现，可用于维护指向单个指针的引用集合。

举例说明

    QPointer<QLabel> label = new QLabel;
    label->setText("&Status:");
    ...
    if (label)
        label->show();

如果QLabel 在此期间被删除，那么label 变量将持有nullptr ，而不是一个无效地址，最后一行将永远不会被执行。

QPointer 可用的函数和运算符与普通无保护指针可用的函数和运算符相同，但指针算术运算符（+,-,++, 和-- ）除外，这些运算符通常只用于对象数组。

像使用普通指针一样使用 QPointers，就不需要阅读本类文档了。

要创建受保护指针，可以从 T* 或另一个相同类型的受保护指针构造或赋值给它们。您可以使用 operator==() 和 operator!=() 将它们相互比较，或使用isNull() 测试nullptr 。您可以使用*x 或x->member 符号对它们进行反引用。

有保护的指针会自动转换为T *，因此可以自由混合使用有保护和无保护的指针。这意味着，如果您有一个 QPointer<QWidget>，您可以将它传递给一个需要QWidget * 的函数。因此，将 QPointer 作为参数声明函数的价值不大；只需使用普通指针即可。当您要长期存储指针时，请使用 QPointer。

请注意，类T 必须继承QObject ，否则会导致编译或链接错误。

另请参阅 QSharedPointer,QObject, 和QObjectCleanupHandler 。

成员函数文档

[noexcept] QPointer::QPointer()

[constexpr noexcept] QPointer::QPointer(std::nullptr_t)

构造一个值为nullptr 的受保护指针。

另请参见 isNull()。

[noexcept, since 6.6] template <typename X, QPointer<T>::if_convertible<X> = true> QPointer::QPointer(QPointer<X> &&other)

[noexcept, since 6.6] template <typename X, QPointer<T>::if_convertible<X> = true> QPointer::QPointer(const QPointer<X> &other)

转换构造函数。通过移动或复制other 构造一个新的QPointer 。

移动后的QPointer 将重置为 nullptr。

注意： 只有当X* 可转换为T* 时，这些构造函数才参与重载解析。

此函数在 Qt 6.6 中引入。

QPointer::QPointer(T *p)

构造一个受保护指针，指向与p 指向相同的对象。

QPointer::~QPointer()

销毁受保护指针。与普通指针一样，销毁受保护指针不会销毁被指向的对象。

[noexcept] void QPointer::clear()

清除QPointer 对象。

另请参见 isNull().

[noexcept] T *QPointer::data() const

返回被保护对象的指针。

[noexcept, since 6.0] T *QPointer::get() const

与data() 相同。提供此函数是为了与 STL 兼容。

此函数在 Qt 6.0 中引入。

[noexcept] bool QPointer::isNull() const

如果引用对象已被销毁或没有引用对象，则返回true ；否则返回false 。

[noexcept] void QPointer::swap(QPointer<T> &other)

将该指针与other 互换。这一操作速度非常快，而且从未出现过故障。

[noexcept] T *QPointer::operator T *() const

投递运算符；实现指针语义。有了这个函数，您就可以将QPointer<T> 传递给需要 T* 的函数。

[noexcept] T &QPointer::operator*() const

取消引用操作符；实现指针语义。只需像使用普通 C++ 指针一样使用该操作符即可。

[noexcept] T *QPointer::operator->() const

重载箭头操作符；实现指针语义。只需像使用普通 C++ 指针一样使用该操作符即可。

[noexcept, since 6.6.1] template <typename X, QPointer<T>::if_convertible<X> = true> QPointer<T> &QPointer::operator=(QPointer<X> &&other)

转换移动赋值操作符。使该受保护指针与other 所保护的对象相同，并将other 重置为 nullptr。

限制条件

只有当X* 可转换为T* 时，才参与重载解析。

此函数在 Qt 6.6.1 中引入。

QPointer<T> &QPointer::operator=(T *p)

赋值操作符。现在，这个受保护指针将指向p 指向的同一对象。

[noexcept, since 6.6] template <typename X, QPointer<T>::if_convertible<X> = true> QPointer<T> &QPointer::operator=(const QPointer<X> &other)

转换赋值操作符。使该受保护指针与other 所保护的对象相同。

限制条件

只有当X* 可转换为T* 时，才参与重载解析。

此函数在 Qt 6.6 中引入。

相关非成员

[noexcept] template <typename X> bool operator!=(X *const &lhs, const QPointer<T> &rhs)

不等式运算符。如果lhs 和受保护指针rhs 不是指向同一个对象，则返回true ，否则返回false 。

[noexcept] template <typename X> bool operator!=(const QPointer<T> &lhs, X *const &rhs)

不等式运算符。如果rhs 和受保护指针lhs 不是指向同一个对象，则返回true ，否则返回false 。

[noexcept(...)] template <typename X> bool operator!=(const QPointer<T> &lhs, const QPointer<X> &rhs)

不等式运算符。如果受保护指针lhs 和rhs 不是指向同一个对象，则返回true ，否则返回false 。

注： 当true 为true 时，此函数为 noexcept。

[noexcept] bool operator!=(const QPointer<T> &lhs, const std::nullptr_t &rhs)

不等式运算符。如果lhs 所保护的指针是有效指针（即不是nullptr ），则返回true ，否则返回false 。

[noexcept] bool operator!=(const std::nullptr_t &lhs, const QPointer<T> &rhs)

不等式运算符。如果rhs 所保护的指针是有效指针（即不是nullptr ），则返回true ，否则返回false 。

[noexcept] template <typename X> bool operator==(X *const &lhs, const QPointer<T> &rhs)

相等运算符。如果lhs 和受保护指针rhs 指向同一个对象，则返回true ，否则返回false 。

[noexcept] template <typename X> bool operator==(const QPointer<T> &lhs, X *const &rhs)

相等运算符。如果rhs 和受保护指针lhs 指向同一个对象，则返回true ，否则返回false 。

[noexcept(...)] template <typename X> bool operator==(const QPointer<T> &lhs, const QPointer<X> &rhs)

相等运算符。如果受保护指针lhs 和rhs 指向同一个对象，则返回true ，否则返回false 。

注： 当true 为true 时，此函数为 noexcept。

[noexcept] bool operator==(const QPointer<T> &lhs, const std::nullptr_t &rhs)

相等运算符。如果lhs 所保护的指针是nullptr ，则返回true ，否则返回false 。

[noexcept] bool operator==(const std::nullptr_t &lhs, const QPointer<T> &rhs)

相等运算符。如果rhs 所保护的指针是nullptr ，则返回true ，否则返回false 。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.