QWeakPointer Class

成员函数文档

QWeakPointer::QWeakPointer()

创建一个指向空值的 QWeakPointer。

QWeakPointer::QWeakPointer(const QSharedPointer<T> &other)

创建一个 QWeakPointer，该对象持有对other 所引指针的弱引用。

如果T 是本类模板参数的派生类型，QWeakPointer 将执行自动类型转换。否则，将会引发编译器错误。

[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

创建一个 QWeakPointer，它持有对由other 所引用的指针的弱引用。

如果T 是本类模板参数的派生类型，QWeakPointer 将执行自动转换。否则，将会引发编译器错误。

QWeakPointer::~QWeakPointer()

销毁此QWeakPointer 对象。该对象引用的指针不会被删除。

void QWeakPointer::clear()

清除此QWeakPointer 对象，并释放其可能持有的指向该指针的引用。

bool QWeakPointer::isNull() const

如果该对象指向nullptr ，则返回true 。

请注意，由于弱引用的特性，QWeakPointer 所引用的指针可能随时变为nullptr ，因此该函数返回的值可能在两次调用之间从 false 变为 true。

QSharedPointer<T> QWeakPointer::lock() const

与toStrongRef()相同。

提供此函数是为了与 std::weak_ptr 保持 API 兼容性。

仅当该智能指针在实现定义的所有者基于排序中位于other 之前时，才返回true 。该排序规则规定：如果两个智能指针均为空，或者它们都拥有同一个对象（即使它们的表观类型和指针不同），则视为等价。

这些函数在 Qt 6.7 中引入。

另请参阅 owner_equal 。

当且仅当此智能指针与other 共享所有权时，返回true 。

这些函数在 Qt 6.7 中引入。

另请参阅 owner_before 和owner_hash 。

[noexcept, since 6.7] size_t QWeakPointer::owner_hash() const

返回此智能指针对象的基于所有者的哈希值。根据owner_equal 的规定，相等的智能指针将具有相同的基于所有者的哈希值。

这些函数在 Qt 6.7 中引入。

另请参阅 owner_equal 。

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

将此弱指针实例与other 互换。此操作速度极快，且绝不会失败。

QSharedPointer<T> QWeakPointer::toStrongRef() const

将此弱引用提升为强引用，并返回一个包含该引用的QSharedPointer 对象。在提升为QSharedPointer 时，该函数会验证该对象是否已被删除。如果尚未被删除，该函数会增加对该共享对象的引用计数，从而确保它不会被删除。

由于该函数可能无法获得对共享对象的有效强引用，因此应始终通过在返回的对象上调用QSharedPointer::isNull() 来验证转换是否成功。

例如，以下代码将一个持有的 `QWeakPointer ` 提升为强引用，如果成功，则打印所持有整数的值：

QWeakPointer<int>weakref;

// ...

QSharedPointer<int>strong=weakref.toStrongRef();
if(strong)
    qDebug() << "The value is:" << *strong;
else
    qDebug() << "The value has already been deleted";

另请参阅 QSharedPointer::QSharedPointer()。

QWeakPointer::operator bool() const

如果所包含的指针不是nullptr ，则返回true 。该函数适用于在if-constructs 中使用，例如：

if (weakref) { /*...*/ }

请注意，由于弱引用的特性，QWeakPointer 所引用的指针随时可能变为nullptr ，因此该函数返回的值可能在两次调用之间从 true 变为 false。

另请参阅 isNull()。

bool QWeakPointer::operator!() const

如果该对象指向nullptr ，则返回true 。该函数适用于if-constructs ，例如：

if (!weakref) { /*...*/ }

请注意，由于弱引用的特性，QWeakPointer 所引用的指针随时可能变为nullptr ，因此该函数返回的值可能在两次调用之间从 false 变为 true。

另请参阅 isNull()。

QWeakPointer<T> &QWeakPointer::operator=(const QSharedPointer<T> &other)

使该对象共享other 的指针。当前的指针引用将被丢弃，但不会被删除。

如果T 是本类模板参数的派生类型，则QWeakPointer 将执行自动类型转换。否则，将会引发编译器错误。

[noexcept] QWeakPointer<T> &QWeakPointer::operator=(const QWeakPointer<T> &other)

使该对象共享other 的指针。当前的指针引用将被丢弃，但不会被删除。

如果T 是本类模板参数的派生类型，则QWeakPointer 将执行自动转换。否则，将引发编译器错误。