QExplicitlySharedDataPointer Class

成员函数文档

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer()

构造一个 QExplicitlySharedDataPointer，以nullptr 作为d 指针初始化。

[explicit noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(T *data)

构造一个 QExplicitlySharedDataPointer，其d 指针设置为data ，并增加data 的引用计数。

[noexcept] template <typename X> QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<X> &o)

这个复制构造函数的不同之处在于，它允许o 成为不同类型的显式共享数据指针，但它拥有兼容的共享数据对象。

默认情况下，o （类型为X * ）的d 指针会被隐式转换为T * 类型；转换的结果会被设置为this 的 d 指针，并且共享数据对象的引用计数会递增。

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<T> &o)

这个标准复制构造函数将this的d 指针设置为o 中的d 指针，并增加共享数据对象的引用计数。

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(QExplicitlySharedDataPointer<T> &&o)

Move- 构造一个 QExplicitlySharedDataPointer 实例，使其指向o 所指向的同一对象。

QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer()

减少共享数据对象的引用计数。如果引用计数为 0，共享数据对象将被删除。然后将其销毁。

[protected] T *QExplicitlySharedDataPointer::clone()

创建并返回当前数据的深度副本。当引用计数大于 1 时，detach() 会调用该函数来创建新副本。该函数使用操作符 new并调用 T 类型的副本构造函数。

有关如何使用该函数的解释，请参见QSharedDataPointer<T>::clone() 。

[noexcept] const T *QExplicitlySharedDataPointer::constData() const

返回指向共享数据对象的常量指针。

另请参见 data()。

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

返回指向共享数据对象的指针。

void QExplicitlySharedDataPointer::detach()

如果共享数据对象的引用计数大于 1，该函数将创建共享数据对象的深度副本，并将其中的d 指针设置为副本。

由于QExplicitlySharedDataPointer 不会像QSharedDataPointer 的成员那样在写操作时自动进行复制，因此该类成员函数中的任何地方都不会自动调用 detach()。如果您发现代码中到处都在调用 detach()，请考虑使用QSharedDataPointer 代替。

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

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

此函数在 Qt 6.0 中引入。

[noexcept, since 6.0] void QExplicitlySharedDataPointer::reset(T *ptr = nullptr)

将this的d 指针设置为ptr ，如果ptr 不是nullptr ，则增加ptr 的引用计数。如果引用计数为 0，则递减旧共享数据对象的引用计数并删除该对象。

此函数在 Qt 6.0 中引入。

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

将这个显式共享数据指针与other 互换。这一操作速度非常快，而且从未出现过故障。

[noexcept] T *QExplicitlySharedDataPointer::take()

返回指向共享对象的指针，并将this重置为nullptr 。（也就是说，该函数将this的d 指针设置为nullptr 。）

[noexcept] bool QExplicitlySharedDataPointer::operator bool() const

如果this的d 指针 不为空，则返回true 。

[noexcept] bool QExplicitlySharedDataPointer::operator!() const

如果this的d 指针为nullptr ，则返回true 。

T &QExplicitlySharedDataPointer::operator*() const

提供对共享数据对象成员的访问权限。

[noexcept] T *QExplicitlySharedDataPointer::operator->()

提供对共享数据对象成员的访问权限。

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

提供对共享数据对象成员的常量访问。

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

Move-assignsother 到此QExplicitlySharedDataPointer 实例。

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(T *o)

将this的d 指针设置为o ，并递增o 的引用计数。this的旧共享数据对象的引用计数会递减。如果旧共享数据对象的引用计数变为 0，则删除旧共享数据对象。

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(const QExplicitlySharedDataPointer<T> &o)

将this的d 指针设置为o 的d 指针，并增加共享数据对象的引用计数。this的旧共享数据对象的引用计数会递减。如果旧共享数据对象的引用计数变为 0，则删除旧共享数据对象。