QWeakPointer 类

成员函数文档

如果且仅当此智能指针在实现定义的基于所有者的顺序中先于other返回true。这种顺序是，如果两个智能指针都是空的或它们都拥有相同的对象（即使它们的类型和指针不同），则认为它们是等效的。

此函数是Qt 6.7中引入的。

另请参阅owner_equal。

如果且仅当此智能指针和other共享所有者时返回true。

此函数是Qt 6.7中引入的。

另请参阅owner_before和owner_hash。

[noexcept, 自6.7以来] size_t QWeakPointer::owner_hash() const

为此智能指针对象返回基于所有者的哈希值。比较相等的智能指针（根据owner_equal）将具有相同的基于所有者的哈希值。

此函数是Qt 6.7中引入的。

另请参阅owner_equal。

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兼容性。

[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。

bool 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。

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

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

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

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

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

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