/**************************************************************************** ** ** Copyright (C) 2020 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QSHAREDDATA_H #define QSHAREDDATA_H #include #include #include #include QT_BEGIN_NAMESPACE template class QSharedDataPointer; class QSharedData { public: mutable QAtomicInt ref; QSharedData() noexcept : ref(0) { } QSharedData(const QSharedData &) noexcept : ref(0) { } // using the assignment operator would lead to corruption in the ref-counting QSharedData &operator=(const QSharedData &) = delete; ~QSharedData() = default; }; struct QAdoptSharedDataTag { explicit constexpr QAdoptSharedDataTag() = default; }; template class QSharedDataPointer { public: typedef T Type; typedef T *pointer; void detach() { if (d && d->ref.loadRelaxed() != 1) detach_helper(); } T &operator*() { detach(); return *d; } const T &operator*() const { return *d; } T *operator->() { detach(); return d; } const T *operator->() const noexcept { return d; } operator T *() { detach(); return d; } operator const T *() const noexcept { return d; } T *data() { detach(); return d; } T *get() { detach(); return d; } const T *data() const noexcept { return d; } const T *get() const noexcept { return d; } const T *constData() const noexcept { return d; } T *take() noexcept { return qExchange(d, nullptr); } QSharedDataPointer() noexcept : d(nullptr) { } ~QSharedDataPointer() { if (d && !d->ref.deref()) delete d; } explicit QSharedDataPointer(T *data) noexcept : d(data) { if (d) d->ref.ref(); } QSharedDataPointer(T *data, QAdoptSharedDataTag) noexcept : d(data) {} QSharedDataPointer(const QSharedDataPointer &o) noexcept : d(o.d) { if (d) d->ref.ref(); } void reset(T *ptr = nullptr) noexcept { if (ptr != d) { if (ptr) ptr->ref.ref(); T *old = qExchange(d, ptr); if (old && !old->ref.deref()) delete old; } } QSharedDataPointer &operator=(const QSharedDataPointer &o) noexcept { reset(o.d); return *this; } inline QSharedDataPointer &operator=(T *o) noexcept { reset(o); return *this; } QSharedDataPointer(QSharedDataPointer &&o) noexcept : d(qExchange(o.d, nullptr)) {} QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_MOVE_AND_SWAP(QSharedDataPointer) operator bool () const noexcept { return d != nullptr; } bool operator!() const noexcept { return d == nullptr; } void swap(QSharedDataPointer &other) noexcept { qSwap(d, other.d); } #define DECLARE_COMPARE_SET(T1, A1, T2, A2) \ friend bool operator<(T1, T2) noexcept \ { return std::less{}(A1, A2); } \ friend bool operator<=(T1, T2) noexcept \ { return !std::less{}(A2, A1); } \ friend bool operator>(T1, T2) noexcept \ { return std::less{}(A2, A1); } \ friend bool operator>=(T1, T2) noexcept \ { return !std::less{}(A1, A2); } \ friend bool operator==(T1, T2) noexcept \ { return A1 == A2; } \ friend bool operator!=(T1, T2) noexcept \ { return A1 != A2; } \ DECLARE_COMPARE_SET(const QSharedDataPointer &p1, p1.d, const QSharedDataPointer &p2, p2.d) DECLARE_COMPARE_SET(const QSharedDataPointer &p1, p1.d, const T *ptr, ptr) DECLARE_COMPARE_SET(const T *ptr, ptr, const QSharedDataPointer &p2, p2.d) DECLARE_COMPARE_SET(const QSharedDataPointer &p1, p1.d, std::nullptr_t, nullptr) DECLARE_COMPARE_SET(std::nullptr_t, nullptr, const QSharedDataPointer &p2, p2.d) protected: T *clone(); private: void detach_helper(); T *d; }; template class QExplicitlySharedDataPointer { public: typedef T Type; typedef T *pointer; T &operator*() const { return *d; } T *operator->() noexcept { return d; } T *operator->() const noexcept { return d; } explicit operator T *() { return d; } explicit operator const T *() const noexcept { return d; } T *data() const noexcept { return d; } T *get() const noexcept { return d; } const T *constData() const noexcept { return d; } T *take() noexcept { return qExchange(d, nullptr); } void detach() { if (d && d->ref.loadRelaxed() != 1) detach_helper(); } QExplicitlySharedDataPointer() noexcept : d(nullptr) { } ~QExplicitlySharedDataPointer() { if (d && !d->ref.deref()) delete d; } explicit QExplicitlySharedDataPointer(T *data) noexcept : d(data) { if (d) d->ref.ref(); } QExplicitlySharedDataPointer(T *data, QAdoptSharedDataTag) noexcept : d(data) {} QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer &o) noexcept : d(o.d) { if (d) d->ref.ref(); } template QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer &o) noexcept #ifdef QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST : d(static_cast(o.data())) #else : d(o.data()) #endif { if (d) d->ref.ref(); } void reset(T *ptr = nullptr) noexcept { if (ptr != d) { if (ptr) ptr->ref.ref(); T *old = qExchange(d, ptr); if (old && !old->ref.deref()) delete old; } } QExplicitlySharedDataPointer &operator=(const QExplicitlySharedDataPointer &o) noexcept { reset(o.d); return *this; } QExplicitlySharedDataPointer &operator=(T *o) noexcept { reset(o); return *this; } QExplicitlySharedDataPointer(QExplicitlySharedDataPointer &&o) noexcept : d(qExchange(o.d, nullptr)) {} QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_MOVE_AND_SWAP(QExplicitlySharedDataPointer) operator bool () const noexcept { return d != nullptr; } bool operator!() const noexcept { return d == nullptr; } void swap(QExplicitlySharedDataPointer &other) noexcept { qSwap(d, other.d); } DECLARE_COMPARE_SET(const QExplicitlySharedDataPointer &p1, p1.d, const QExplicitlySharedDataPointer &p2, p2.d) DECLARE_COMPARE_SET(const QExplicitlySharedDataPointer &p1, p1.d, const T *ptr, ptr) DECLARE_COMPARE_SET(const T *ptr, ptr, const QExplicitlySharedDataPointer &p2, p2.d) DECLARE_COMPARE_SET(const QExplicitlySharedDataPointer &p1, p1.d, std::nullptr_t, nullptr) DECLARE_COMPARE_SET(std::nullptr_t, nullptr, const QExplicitlySharedDataPointer &p2, p2.d) #undef DECLARE_COMPARE_SET protected: T *clone(); private: void detach_helper(); T *d; }; // Declared here and as Q_OUTOFLINE_TEMPLATE to work-around MSVC bug causing missing symbols at link time. template Q_INLINE_TEMPLATE T *QSharedDataPointer::clone() { return new T(*d); } template Q_OUTOFLINE_TEMPLATE void QSharedDataPointer::detach_helper() { T *x = clone(); x->ref.ref(); if (!d->ref.deref()) delete d; d = x; } template Q_INLINE_TEMPLATE T *QExplicitlySharedDataPointer::clone() { return new T(*d); } template Q_OUTOFLINE_TEMPLATE void QExplicitlySharedDataPointer::detach_helper() { T *x = clone(); x->ref.ref(); if (!d->ref.deref()) delete d; d = x; } template void swap(QSharedDataPointer &p1, QSharedDataPointer &p2) noexcept { p1.swap(p2); } template void swap(QExplicitlySharedDataPointer &p1, QExplicitlySharedDataPointer &p2) noexcept { p1.swap(p2); } template size_t qHash(const QSharedDataPointer &ptr, size_t seed = 0) noexcept { return qHash(ptr.data(), seed); } template size_t qHash(const QExplicitlySharedDataPointer &ptr, size_t seed = 0) noexcept { return qHash(ptr.data(), seed); } template Q_DECLARE_TYPEINFO_BODY(QSharedDataPointer, Q_RELOCATABLE_TYPE); template Q_DECLARE_TYPEINFO_BODY(QExplicitlySharedDataPointer, Q_RELOCATABLE_TYPE); #define QT_DECLARE_QSDP_SPECIALIZATION_DTOR(Class) \ template<> QSharedDataPointer::~QSharedDataPointer(); #define QT_DECLARE_QSDP_SPECIALIZATION_DTOR_WITH_EXPORT(Class, ExportMacro) \ template<> ExportMacro QSharedDataPointer::~QSharedDataPointer(); #define QT_DEFINE_QSDP_SPECIALIZATION_DTOR(Class) \ template<> QSharedDataPointer::~QSharedDataPointer() \ { \ if (d && !d->ref.deref()) \ delete d; \ } #define QT_DECLARE_QESDP_SPECIALIZATION_DTOR(Class) \ template<> QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer(); #define QT_DECLARE_QESDP_SPECIALIZATION_DTOR_WITH_EXPORT(Class, ExportMacro) \ template<> ExportMacro QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer(); #define QT_DEFINE_QESDP_SPECIALIZATION_DTOR(Class) \ template<> QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer() \ { \ if (d && !d->ref.deref()) \ delete d; \ } QT_END_NAMESPACE #endif // QSHAREDDATA_H