QExplicitlySharedDataPointer 类

成员函数文档

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer()

使用nullptr作为指针d构造QExplicitlySharedDataPointer。

[explicit noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(T *数据)

使用数据设置指针d并增加数据的引用计数，以构造QExplicitlySharedDataPointer。

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

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

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

然而，如果在使用QExplicitlySharedDataPointer头文件前定义了宏QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST，那么o的指针d将经过一个static_cast转换为类型T *。然后将这个转换的结果设置为this的指针d，并增加共享数据对象的引用计数。

    QExplicitlySharedDataPointer<Base> base(new Base);
    QExplicitlySharedDataPointer<Derived> derived(base); // !!! DANGER !!!

从 Qt 5.4 开始，默认禁用此类型转换。可以通过定义宏 QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST 来重新启用它，因此无需修改即可允许旧代码（依赖于此功能）编译。

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

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

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

将 QExplicitlySharedDataPointer 实例移动构造，使其指向与 o 指向相同的对象。

QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer()

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

[protected] T *QExplicitlySharedDataPointer::clone()

创建并返回当前数据的深度副本。当引用计数大于 1 时，此函数由 detach() 调用来创建新的副本。此函数使用 operator new 并调用类型 T 的复制构造函数。

有关如何使用它的说明，请参阅 QSharedDataPointer<T>::clone()。

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

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

另请参阅 data().

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

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

void QExplicitlySharedDataPointer::detach()

如果共享数据对象的引用计数大于 1，此函数会创建共享数据对象的深度副本，并将 this 的 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)

将该对象的 指针 设置为 ptr，如果 ptr 不是 nullptr，则增加 ptr 的引用计数。旧共享数据对象的引用计数减少，当引用计数达到 0 时，对象被删除。

此函数在 Qt 6.0 中引入。

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

将此实例的显式共享数据指针与 other 中的显式共享数据指针交换。

[noexcept] T *QExplicitlySharedDataPointer::take()

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

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

如果 this 的 指针 不是 null，则返回 true。

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

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

T &QExplicitlySharedDataPointer::operator*() const

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

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

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

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

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

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

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

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

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

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

将《other》移至当前QExplicitlySharedDataPointer 实例。