qvariant.h

Go to the documentation of this file.

// Copyright (C) 2020 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:critical reason:data-parser
 
#ifndef QVARIANT_H
#define QVARIANT_H
 
#include <QtCore/qatomic.h>
#include <QtCore/qcompare.h>
#include <QtCore/qcontainerfwd.h>
#include <QtCore/qmetatype.h>
#ifndef QT_NO_DEBUG_STREAM
#include <QtCore/qdebug.h>
#endif
 
#include <memory>
#include <QtCore/q20type_traits.h>
#include <QtCore/q23utility.h>
#include <variant>
 
#if !defined(QT_LEAN_HEADERS) || QT_LEAN_HEADERS < 1
#  include <QtCore/qlist.h>
#  include <QtCore/qstringlist.h>
#  include <QtCore/qbytearraylist.h>
#  include <QtCore/qhash.h>
#  include <QtCore/qmap.h>
#  include <QtCore/qobject.h>
#endif
 
QT_BEGIN_NAMESPACE
 
QT_ENABLE_P0846_SEMANTICS_FOR(get_if)
QT_ENABLE_P0846_SEMANTICS_FOR(get)
 
class QBitArray;
class QDataStream;
class QDate;
class QDateTime;
class QEasingCurve;
class QLine;
class QLineF;
class QLocale;
class QModelIndex;
class QPersistentModelIndex;
class QPoint;
class QPointF;
class QRect;
class QRectF;
class QRegularExpression;
class QSize;
class QSizeF;
class QTextFormat;
class QTextLength;
class QTime;
class QTransform;
class QUrl;
class QVariant;
 
template<typename T>
inline T qvariant_cast(const QVariant &);
 
namespace QtPrivate {
template<> constexpr inline bool qIsRelocatable<QVariant> = true;
 
} // namespace QtPrivate
 
class Q_CORE_EXPORT QVariant
{
    template <typename T, typename... Args>
    using if_constructible = std::enable_if_t<
        std::conjunction_v<
            std::is_copy_constructible<q20::remove_cvref_t<T>>,
            std::is_destructible<q20::remove_cvref_t<T>>,
            std::is_constructible<q20::remove_cvref_t<T>, Args...>
        >,
    bool>;
 
    template <typename T>
    using if_rvalue = std::enable_if_t<!std::is_reference_v<T>, bool>;
 
    struct CborValueStandIn { qint64 n; void *c; int t; };
public:
    struct PrivateShared
    {
    private:
        inline PrivateShared() : ref(1) { }
    public:
        static int computeOffset(PrivateShared *ps, size_t align);
        static size_t computeAllocationSize(size_t size, size_t align);
        static PrivateShared *create(size_t size, size_t align);
        static void free(PrivateShared *p);
 
        alignas(8) QAtomicInt ref;
        int offset;
 
        const void *data() const { return reinterpret_cast<const uchar *>(this) + offset; }
        void *data() { return reinterpret_cast<uchar *>(this) + offset; }
    };
 
    struct Private
    {
        static constexpr size_t MaxInternalSize = 3 * sizeof(void *);
        template <size_t S> static constexpr bool FitsInInternalSize = S <= MaxInternalSize;
        template<typename T> static constexpr bool CanUseInternalSpace =
                (QTypeInfo<T>::isRelocatable && FitsInInternalSize<sizeof(T)> && alignof(T) <= alignof(double));
        static constexpr bool canUseInternalSpace(const QtPrivate::QMetaTypeInterface *type)
        {
            Q_ASSERT(type);
            return QMetaType::TypeFlags(type->flags) & QMetaType::RelocatableType &&
                   size_t(type->size) <= MaxInternalSize && size_t(type->alignment) <= alignof(double);
        }
 
        union
        {
            uchar data[MaxInternalSize] = {};
            PrivateShared *shared;
            double _forAlignment; // we want an 8byte alignment on 32bit systems as well
        } data;
        quintptr is_shared : 1;
        quintptr is_null : 1;
        quintptr packedType : sizeof(QMetaType) * 8 - 2;
 
        constexpr Private() noexcept : is_shared(false), is_null(true), packedType(0) {}
        explicit Private(const QtPrivate::QMetaTypeInterface *iface) noexcept;
        template <typename T>
        explicit Private(std::in_place_t, T &&t);
#if QT_DEPRECATED_SINCE(6, 12)
        template <typename T>
        QT_DEPRECATED_VERSION_X_6_12("use the std::in_place overload and check whether you can move into it.")
        explicit Private(std::piecewise_construct_t, const T &t)
            : Private{std::in_place, t} {}
#endif
 
        const void *storage() const
        { return is_shared ? data.shared->data() : &data.data; }
 
        template<typename T> const T &get() const
        { return *static_cast<const T *>(storage()); }
 
        inline const QtPrivate::QMetaTypeInterface *typeInterface() const
        {
            return reinterpret_cast<const QtPrivate::QMetaTypeInterface *>(packedType << 2);
        }
 
        inline QMetaType type() const
        {
            return QMetaType(typeInterface());
        }
    };
 
#if QT_DEPRECATED_SINCE(6, 0)
    enum QT_DEPRECATED_VERSION_X_6_0("Use QMetaType::Type instead.") Type
    {
        Invalid = QMetaType::UnknownType,
        Bool = QMetaType::Bool,
        Int = QMetaType::Int,
        UInt = QMetaType::UInt,
        LongLong = QMetaType::LongLong,
        ULongLong = QMetaType::ULongLong,
        Double = QMetaType::Double,
        Char = QMetaType::QChar,
        Map = QMetaType::QVariantMap,
        List = QMetaType::QVariantList,
        String = QMetaType::QString,
        StringList = QMetaType::QStringList,
        ByteArray = QMetaType::QByteArray,
        BitArray = QMetaType::QBitArray,
        Date = QMetaType::QDate,
        Time = QMetaType::QTime,
        DateTime = QMetaType::QDateTime,
        Url = QMetaType::QUrl,
        Locale = QMetaType::QLocale,
        Rect = QMetaType::QRect,
        RectF = QMetaType::QRectF,
        Size = QMetaType::QSize,
        SizeF = QMetaType::QSizeF,
        Line = QMetaType::QLine,
        LineF = QMetaType::QLineF,
        Point = QMetaType::QPoint,
        PointF = QMetaType::QPointF,
#if QT_CONFIG(regularexpression)
        RegularExpression = QMetaType::QRegularExpression,
#endif
        Hash = QMetaType::QVariantHash,
#if QT_CONFIG(easingcurve)
        EasingCurve = QMetaType::QEasingCurve,
#endif
        Uuid = QMetaType::QUuid,
#if QT_CONFIG(itemmodel)
        ModelIndex = QMetaType::QModelIndex,
        PersistentModelIndex = QMetaType::QPersistentModelIndex,
#endif
        LastCoreType = QMetaType::LastCoreType,
 
        Font = QMetaType::QFont,
        Pixmap = QMetaType::QPixmap,
        Brush = QMetaType::QBrush,
        Color = QMetaType::QColor,
        Palette = QMetaType::QPalette,
        Image = QMetaType::QImage,
        Polygon = QMetaType::QPolygon,
        Region = QMetaType::QRegion,
        Bitmap = QMetaType::QBitmap,
        Cursor = QMetaType::QCursor,
#if QT_CONFIG(shortcut)
        KeySequence = QMetaType::QKeySequence,
#endif
        Pen = QMetaType::QPen,
        TextLength = QMetaType::QTextLength,
        TextFormat = QMetaType::QTextFormat,
        Transform = QMetaType::QTransform,
        Matrix4x4 = QMetaType::QMatrix4x4,
        Vector2D = QMetaType::QVector2D,
        Vector3D = QMetaType::QVector3D,
        Vector4D = QMetaType::QVector4D,
        Quaternion = QMetaType::QQuaternion,
        PolygonF = QMetaType::QPolygonF,
        Icon = QMetaType::QIcon,
        LastGuiType = QMetaType::LastGuiType,
 
        SizePolicy = QMetaType::QSizePolicy,
 
        UserType = QMetaType::User,
        LastType = 0xffffffff // need this so that gcc >= 3.4 allocates 32 bits for Type
    };
#endif
    QVariant() noexcept : d() {}
    ~QVariant();
    explicit QVariant(QMetaType type, const void *copy = nullptr);
    QVariant(const QVariant &other);
 
private:
    template <typename T, typename ...Args>
    using is_noexcept_constructible = std::conjunction<
            std::bool_constant<Private::CanUseInternalSpace<T>>,
            std::is_nothrow_constructible<T, Args...>
        >;
 
public:
    template<typename Indirect>
    class Reference;
 
    template<typename Indirect>
    class ConstReference
    {
    private:
        friend class Reference<Indirect>;
        const Indirect m_referred;
 
    public:
        // You can initialize a const reference from another one, but you can't assign to it.
 
        explicit ConstReference(const Indirect &referred)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
            : m_referred(referred) {}
        explicit ConstReference(Indirect &&referred)
                noexcept(std::is_nothrow_move_constructible_v<Indirect>)
            : m_referred(std::move(referred)) {}
        ConstReference(const ConstReference &)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>) = default;
 
        // Move-constructing a reference from another one is not valid C++. You can't do this:
        //     A a;
        //     const A &ra(a);
        //     const A &rb(std::move(ra));
        ConstReference(ConstReference &&) = delete;
 
        ConstReference(const Reference<Indirect> &)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>);
 
        // Move-constructing a reference from another one is not valid C++. You can't do this:
        //     A a;
        //     A &ra(a);
        //     const A &rb(std::move(ra));
        // ConstReference(Reference<Indirect> &&) = delete;
 
        ~ConstReference() = default;
        ConstReference &operator=(const ConstReference &value) = delete;
        ConstReference &operator=(ConstReference &&value) = delete;
 
        // To be specialized for each Indirect
        operator QVariant() const noexcept(Indirect::CanNoexceptConvertToQVariant);
    };
 
    template<typename Indirect>
    class Reference
    {
    private:
        friend class ConstReference<Indirect>;
        Indirect m_referred;
 
        friend void swap(Reference a, Reference b) { return a.swap(b); }
 
    public:
        // Assigning and initializing are different operations for references.
 
        explicit Reference(const Indirect &referred)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
            : m_referred(referred) {}
        explicit Reference(Indirect &&referred)
                noexcept(std::is_nothrow_move_constructible_v<Indirect>)
            : m_referred(std::move(referred)) {}
        Reference(const Reference &) = default;
 
        // Move-constructing a reference from another one is not valid C++. You can't do this:
        //     A a;
        //     A &ra(a);
        //     A &rb(std::move(ra));
        Reference(Reference &&) = delete;
 
        ~Reference() = default;
 
        Reference &operator=(const Reference &value)
                noexcept(Indirect::CanNoexceptAssignQVariant)
        {
            return operator=(QVariant(value));
        }
 
        Reference &operator=(Reference &&value)
                noexcept(Indirect::CanNoexceptAssignQVariant)
        {
            return operator=(QVariant(value));
        }
 
        Reference &operator=(const ConstReference<Indirect> &value)
                noexcept(Indirect::CanNoexceptAssignQVariant)
        {
            return operator=(QVariant(value));
        }
 
        Reference &operator=(ConstReference<Indirect> &&value)
                noexcept(Indirect::CanNoexceptAssignQVariant)
        {
            return operator=(QVariant(value));
        }
 
        operator QVariant() const noexcept(Indirect::CanNoexceptConvertToQVariant)
        {
            return ConstReference<Indirect>(m_referred);
        }
 
        void swap(Reference b)
        {
            // swapping a reference is not swapping the referred item, but swapping its contents.
            QVariant tmp = *this;
            *this = std::move(b);
            b = std::move(tmp);
        }
 
        // To be specialized for each Indirect
        Reference &operator=(const QVariant &value) noexcept(Indirect::CanNoexceptAssignQVariant);
    };
 
    template<typename Indirect>
    class ConstPointer
    {
    private:
        Indirect m_pointed;
 
    public:
        explicit ConstPointer(const Indirect &pointed)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
            : m_pointed(pointed) {}
        explicit ConstPointer(Indirect &&pointed)
                noexcept(std::is_nothrow_move_constructible_v<Indirect>)
            : m_pointed(std::move(pointed)) {}
 
        ConstReference<Indirect> operator*()
                const noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
        {
            return ConstReference<Indirect>(m_pointed);
        }
    };
 
    template<typename Indirect>
    class Pointer
    {
    private:
        Indirect m_pointed;
 
    public:
        explicit Pointer(const Indirect &pointed)
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
            : m_pointed(pointed) {}
        explicit Pointer(Indirect &&pointed)
                noexcept(std::is_nothrow_move_constructible_v<Indirect>)
            : m_pointed(std::move(pointed)) {}
 
        Reference<Indirect> operator*()
                const noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
        {
            return Reference<Indirect>(m_pointed);
        }
 
        operator ConstPointer<Indirect>() const
                noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
        {
            return ConstPointer<Indirect>(m_pointed);
        }
    };
 
    template <typename T, typename... Args,
             if_constructible<T, Args...> = true>
    explicit QVariant(std::in_place_type_t<T>, Args&&... args)
            noexcept(is_noexcept_constructible<q20::remove_cvref_t<T>, Args...>::value)
        : QVariant(std::in_place, QMetaType::fromType<q20::remove_cvref_t<T>>() )
    {
        void *data = const_cast<void *>(constData());
        new (data) T(std::forward<Args>(args)...);
    }
 
    template <typename T, typename U, typename... Args,
             if_constructible<T, std::initializer_list<U> &, Args...> = true>
    explicit QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args&&... args)
            noexcept(is_noexcept_constructible<q20::remove_cvref_t<T>,
                                               std::initializer_list<U> &,
                                               Args...
                    >::value)
        : QVariant(std::in_place, QMetaType::fromType<q20::remove_cvref_t<T>>())
    {
        void *data = const_cast<void *>(constData());
        new (data) T(il, std::forward<Args>(args)...);
    }
 
    // primitives
    QVariant(int i) noexcept;
    QVariant(uint ui) noexcept;
    QVariant(qlonglong ll) noexcept;
    QVariant(qulonglong ull) noexcept;
    QVariant(bool b) noexcept;
    QVariant(double d) noexcept;
    QVariant(float f) noexcept;
 
    // trivial, trivially-copyable or COW
    QVariant(QChar qchar) noexcept;
    QVariant(QDate date) noexcept;
    QVariant(QTime time) noexcept;
    QVariant(const QBitArray &bitarray) noexcept;
    QVariant(QBitArray &&bitarray) noexcept;
    QVariant(const QByteArray &bytearray) noexcept;
    QVariant(QByteArray &&bytearray) noexcept;
    QVariant(const QDateTime &datetime) noexcept;
    QVariant(QDateTime &&datetime) noexcept;
    QVariant(const QHash<QString, QVariant> &hash) noexcept;
    QVariant(QHash<QString, QVariant> &&hash) noexcept;
    QVariant(const QJsonArray &jsonArray) noexcept;
    QVariant(QJsonArray &&jsonArray) noexcept;
    QVariant(const QJsonObject &jsonObject) noexcept;
    QVariant(QJsonObject &&jsonObject) noexcept;
    QVariant(const QList<QVariant> &list) noexcept;
    QVariant(QList<QVariant> &&list) noexcept;
    QVariant(const QLocale &locale) noexcept;
    QVariant(QLocale &&locale) noexcept;
    QVariant(const QMap<QString, QVariant> &map) noexcept;
    QVariant(QMap<QString, QVariant> &&map) noexcept;
    QVariant(const QRegularExpression &re) noexcept;
    QVariant(QRegularExpression &&re) noexcept;
    QVariant(const QString &string) noexcept;
    QVariant(QString &&string) noexcept;
    QVariant(const QStringList &stringlist) noexcept;
    QVariant(QStringList &&stringlist) noexcept;
    QVariant(const QUrl &url) noexcept;
    QVariant(QUrl &&url) noexcept;
 
    // conditionally noexcept trivial or trivially-copyable
    // (most of these are noexcept on 64-bit)
    QVariant(const QJsonValue &jsonValue) noexcept(Private::FitsInInternalSize<sizeof(CborValueStandIn)>);
    QVariant(QJsonValue &&jsonValue) noexcept(Private::FitsInInternalSize<sizeof(CborValueStandIn)>);
    QVariant(const QModelIndex &modelIndex) noexcept(Private::FitsInInternalSize<8 + 2 * sizeof(quintptr)>);
    QVariant(QUuid uuid) noexcept(Private::FitsInInternalSize<16>);
    QVariant(QSize size) noexcept;
    QVariant(QSizeF size) noexcept(Private::FitsInInternalSize<sizeof(qreal) * 2>);
    QVariant(QPoint pt) noexcept;
    QVariant(QPointF pt) noexcept(Private::FitsInInternalSize<sizeof(qreal) * 2>);
    QVariant(QLine line) noexcept(Private::FitsInInternalSize<sizeof(int) * 4>);
    QVariant(QLineF line) noexcept(Private::FitsInInternalSize<sizeof(qreal) * 4>);
    QVariant(QRect rect) noexcept(Private::FitsInInternalSize<sizeof(int) * 4>);
    QVariant(QRectF rect) noexcept(Private::FitsInInternalSize<sizeof(qreal) * 4>);
 
    // not noexcept
    QVariant(const QEasingCurve &easing) noexcept(false);
    QVariant(QEasingCurve &&easing) noexcept;
    QVariant(const QJsonDocument &jsonDocument) noexcept(false);
    QVariant(QJsonDocument &&jsonDocument) noexcept;
    QVariant(const QPersistentModelIndex &modelIndex) noexcept(false);
    QVariant(QPersistentModelIndex &&modelIndex) noexcept;
 
#ifndef QT_NO_CAST_FROM_ASCII
    QT_ASCII_CAST_WARN QVariant(const char *str) noexcept(false)
        : QVariant(QString::fromUtf8(str))
    {}
#endif
    QVariant(QLatin1StringView string) noexcept(false); // converts to QString
 
#if !defined(Q_CC_GHS)
    // GHS has an ICE with this code; use the simplified version below
    template <typename T,
              std::enable_if_t<std::disjunction_v<std::is_pointer<T>, std::is_member_pointer<T>>, bool> = false>
    QVariant(T) = delete;
#else
    QVariant(const volatile void *) = delete;
#endif
 
#if QT_CORE_REMOVED_SINCE(6, 5)
    QVariant(const QSize &size);
    QVariant(const QSizeF &size);
    QVariant(const QPoint &pt);
    QVariant(const QPointF &pt);
    QVariant(const QLine &line);
    QVariant(const QLineF &line);
    QVariant(const QRect &rect);
    QVariant(const QRectF &rect);
    QVariant(const QUuid &uuid);
#endif
 
    QVariant& operator=(const QVariant &other);
    inline QVariant(QVariant &&other) noexcept : d(other.d)
    { other.d = Private(); }
    QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_MOVE_AND_SWAP(QVariant)
 
    inline void swap(QVariant &other) noexcept { std::swap(d, other.d); }
 
    int userType() const { return typeId(); }
    int typeId() const
    {
        // QVariant types are always registered (see fromMetaType())
        const QtPrivate::QMetaTypeInterface *mt = metaType().iface();
        if (!mt)
            return 0;
        int id = mt->typeId.loadRelaxed();
        Q_PRESUME(id > 0);
        return id;
    }
 
    QT_CORE_INLINE_SINCE(6, 10)
    const char *typeName() const;
    QT_CORE_INLINE_SINCE(6, 10)
    QMetaType metaType() const;
 
    bool canConvert(QMetaType targetType) const
    { return QMetaType::canConvert(d.type(), targetType); }
    bool convert(QMetaType type);
 
    bool canView(QMetaType targetType) const
    { return QMetaType::canView(d.type(), targetType); }
 
#if QT_DEPRECATED_SINCE(6, 0)
    QT_DEPRECATED_VERSION_6_0
    bool canConvert(int targetTypeId) const
    { return QMetaType::canConvert(d.type(), QMetaType(targetTypeId)); }
    QT_DEPRECATED_VERSION_6_0
    bool convert(int targetTypeId)
    { return convert(QMetaType(targetTypeId)); }
#endif
 
    inline bool isValid() const;
    bool isNull() const;
 
    void clear();
 
    void detach();
    inline bool isDetached() const;
 
    int toInt(bool *ok = nullptr) const;
    uint toUInt(bool *ok = nullptr) const;
    qlonglong toLongLong(bool *ok = nullptr) const;
    qulonglong toULongLong(bool *ok = nullptr) const;
    bool toBool() const;
    double toDouble(bool *ok = nullptr) const;
    float toFloat(bool *ok = nullptr) const;
    qreal toReal(bool *ok = nullptr) const;
    QByteArray toByteArray() const;
    QBitArray toBitArray() const;
    QString toString() const;
    QStringList toStringList() const;
    QChar toChar() const;
    QDate toDate() const;
    QTime toTime() const;
    QDateTime toDateTime() const;
    QList<QVariant> toList() const;
    QMap<QString, QVariant> toMap() const;
    QHash<QString, QVariant> toHash() const;
 
    QPoint toPoint() const;
    QPointF toPointF() const;
    QRect toRect() const;
    QSize toSize() const;
    QSizeF toSizeF() const;
    QLine toLine() const;
    QLineF toLineF() const;
    QRectF toRectF() const;
    QLocale toLocale() const;
#if QT_CONFIG(regularexpression)
    QRegularExpression toRegularExpression() const;
#endif // QT_CONFIG(regularexpression)
#if QT_CONFIG(easingcurve)
    QEasingCurve toEasingCurve() const;
#endif
    QUuid toUuid() const;
    QUrl toUrl() const;
    QJsonValue toJsonValue() const;
    QJsonObject toJsonObject() const;
    QJsonArray toJsonArray() const;
    QJsonDocument toJsonDocument() const;
#if QT_CONFIG(itemmodel)
    QModelIndex toModelIndex() const;
    QPersistentModelIndex toPersistentModelIndex() const;
#endif
 
#ifndef QT_NO_DATASTREAM
    void load(QDataStream &ds);
    void save(QDataStream &ds) const;
#endif
#if QT_DEPRECATED_SINCE(6, 0)
    QT_WARNING_PUSH
    QT_WARNING_DISABLE_DEPRECATED
    QT_DEPRECATED_VERSION_X_6_0("Use the constructor taking a QMetaType instead.")
    explicit QVariant(Type type)
        : QVariant(QMetaType(int(type)))
    {}
    QT_DEPRECATED_VERSION_X_6_0("Use typeId() or metaType().")
    Type type() const
    {
        int type = d.type().rawId();
        return type >= QMetaType::User ? UserType : static_cast<Type>(type);
    }
    QT_DEPRECATED_VERSION_6_0
    static const char *typeToName(int typeId)
    { return QMetaType(typeId).name(); }
    QT_DEPRECATED_VERSION_6_0
    static Type nameToType(const char *name)
    {
        int metaType = QMetaType::fromName(name).rawId();
        return metaType <= int(UserType) ? QVariant::Type(metaType) : UserType;
    }
    QT_WARNING_POP
#endif
 
    void *data();
    const void *constData() const
    { return d.storage(); }
    inline const void *data() const { return constData(); }
 
private:
    template <typename T>
    void verifySuitableForEmplace()
    {
        static_assert(!std::is_reference_v<T>,
                      "QVariant does not support reference types");
        static_assert(!std::is_const_v<T>,
                      "QVariant does not support const types");
        static_assert(std::is_copy_constructible_v<T>,
                      "QVariant requires that the type is copyable");
        static_assert(std::is_destructible_v<T>,
                      "QVariant requires that the type is destructible");
    }
 
    template <typename T, typename... Args>
    T &emplaceImpl(Args&&... args)
    {
        verifySuitableForEmplace<T>();
        auto data = static_cast<T *>(prepareForEmplace(QMetaType::fromType<T>()));
        return *q20::construct_at(data, std::forward<Args>(args)...);
    }
 
public:
    template <typename T, typename... Args,
              if_constructible<T, Args...> = true>
    T &emplace(Args&&... args)
    {
        return emplaceImpl<T>(std::forward<Args>(args)...);
    }
 
    template <typename T, typename U, typename... Args,
             if_constructible<T, std::initializer_list<U> &, Args...> = true>
    T &emplace(std::initializer_list<U> list, Args&&... args)
    {
        return emplaceImpl<T>(list, std::forward<Args>(args)...);
    }
 
    template<typename T, typename = std::enable_if_t<!std::is_same_v<std::decay_t<T>, QVariant>>>
    void setValue(T &&avalue)
    {
        using VT = std::decay_t<T>;
        QMetaType metaType = QMetaType::fromType<VT>();
        // If possible we reuse the current QVariant private.
        if (isDetached() && d.type() == metaType) {
            *reinterpret_cast<VT *>(const_cast<void *>(constData())) = std::forward<T>(avalue);
            d.is_null = false;
        } else {
            *this = QVariant::fromValue<VT>(std::forward<T>(avalue));
        }
    }
 
    void setValue(const QVariant &avalue)
    {
        *this = avalue;
    }
 
    void setValue(QVariant &&avalue)
    {
        *this = std::move(avalue);
    }
 
    template<typename T>
    inline T value() const &
    { return qvariant_cast<T>(*this); }
 
    template<typename T>
    inline T view()
    {
        T t{};
        QMetaType::view(metaType(), data(), QMetaType::fromType<T>(), &t);
        return t;
    }
 
    template<typename T>
    inline T value() &&
    { return qvariant_cast<T>(std::move(*this)); }
 
    template<typename T, if_rvalue<T> = true>
#ifndef Q_QDOC
        /* needs is_copy_constructible for variants semantics, is_move_constructible so that moveConstruct works
          (but copy_constructible implies move_constructble, so don't bother checking)
        */
    static inline auto fromValue(T &&value)
        noexcept(std::is_nothrow_copy_constructible_v<T> && Private::CanUseInternalSpace<T>)
        -> std::enable_if_t<std::conjunction_v<std::is_copy_constructible<T>,
                                               std::is_destructible<T>>, QVariant>
#else
    static inline QVariant fromValue(T &&value)
#endif
    {
        // handle special cases
        using Type = std::remove_cv_t<T>;
        if constexpr (std::is_null_pointer_v<Type>)
            return QVariant::fromMetaType(QMetaType::fromType<std::nullptr_t>());
        else if constexpr (std::is_same_v<Type, QVariant>)
            return std::forward<T>(value);
        else if constexpr (std::is_same_v<Type, std::monostate>)
            return QVariant();
        QMetaType mt = QMetaType::fromType<Type>();
        mt.registerType(); // we want the type stored in QVariant to always be registered
 
        // We only try to move if the type is actually moveable and not if T is const
        // as in const int i; QVariant::fromValue(std::move(i));
        if constexpr (std::conjunction_v<std::is_move_constructible<Type>, std::negation<std::is_const<T>>>)
            return moveConstruct(QMetaType::fromType<Type>(), std::addressof(value));
        else
            return copyConstruct(mt, std::addressof(value));
    }
 
    template<typename T>
#ifndef Q_QDOC
    static inline auto fromValue(const T &value)
        noexcept(std::is_nothrow_copy_constructible_v<T> && Private::CanUseInternalSpace<T>)
        -> std::enable_if_t<std::is_copy_constructible_v<T> && std::is_destructible_v<T>, QVariant>
#else
    static inline QVariant fromValue(const T &value)
#endif
    {
        if constexpr (std::is_null_pointer_v<T>)
            return QVariant(QMetaType::fromType<std::nullptr_t>());
        else if constexpr (std::is_same_v<T, QVariant>)
            return value;
        else if constexpr (std::is_same_v<T, std::monostate>)
            return QVariant();
        return QVariant(QMetaType::fromType<T>(), std::addressof(value));
    }
 
    template<typename... Types>
    static inline QVariant fromStdVariant(const std::variant<Types...> &value)
    {
        return fromStdVariantImpl(value);
    }
 
    template<typename... Types>
    static QVariant fromStdVariant(std::variant<Types...> &&value)
    {
        return fromStdVariantImpl(std::move(value));
    }
 
    static QVariant fromMetaType(QMetaType type, const void *copy = nullptr);
 
    template<typename T>
    bool canConvert() const
    { return canConvert(QMetaType::fromType<T>()); }
 
    template<typename T>
    bool canView() const
    { return canView(QMetaType::fromType<T>()); }
 
    static QPartialOrdering compare(const QVariant &lhs, const QVariant &rhs);
 
private:
    template <typename StdVariant>
    static QVariant fromStdVariantImpl(StdVariant &&v)
    {
        if (Q_UNLIKELY(v.valueless_by_exception()))
            return QVariant();
        auto visitor = [](auto &&arg) {
            return QVariant::fromValue(q23::forward_like<StdVariant>(arg));
        };
        return std::visit(visitor, std::forward<StdVariant>(v));
    }
 
    friend bool comparesEqual(const QVariant &a, const QVariant &b)
    { return a.equals(b); }
    Q_DECLARE_EQUALITY_COMPARABLE_NON_NOEXCEPT(QVariant)
 
#ifndef QT_NO_DEBUG_STREAM
    template <typename T>
    friend auto operator<<(const QDebug &debug, const T &variant) -> std::enable_if_t<std::is_same_v<T, QVariant>, QDebug> {
        return  variant.qdebugHelper(debug);
    }
    QDebug qdebugHelper(QDebug) const;
#endif
 
    template <typename T, typename Variant> static constexpr
    bool canGetTypeFromVariant(Variant *v) noexcept
    {
        if (!v)
            return false;
        if (std::is_const_v<Variant> && v->d.is_null)
            return false;       // (const) data() will not detach from is_null
 
        using NonConstT = std::remove_const_t<std::remove_pointer_t<T>>;
        if constexpr (std::is_pointer_v<T> && !std::is_same_v<T, NonConstT *>) {
            if (v->d.type() == QMetaType::fromType<NonConstT *>())
                return true;
        }
        return v->d.type() == QMetaType::fromType<T>();
    }
 
    template <typename T> T *typedData()
    {
        Q_PRE(canGetTypeFromVariant<T>(this));
        return static_cast<T *>(data());    // detaches if necessary
    }
 
    template <typename T> const T *typedData() const
    {
        Q_PRE(canGetTypeFromVariant<T>(this));
        return &d.get<T>();
    }
 
    template <typename T>
    friend T *get_if(QVariant *v) noexcept
    {
        if (!canGetTypeFromVariant<T>(v))
            return nullptr;
        return v->typedData<T>();
    }
    template <typename T>
    friend const T *get_if(const QVariant *v) noexcept
    {
        if (!canGetTypeFromVariant<T>(v))
            return nullptr;
        return v->typedData<const T>();
    }
 
#define Q_MK_GET(CONST, REF)
    template <typename T> friend CONST T REF get(CONST QVariant REF v)
    { return static_cast<CONST T REF>(*v.typedData<T>()); }
    /* end */
    Q_MK_GET(, &)
    Q_MK_GET(const, &)
    Q_MK_GET(, &&)
    Q_MK_GET(const, &&)
#undef Q_MK_GET
 
    static QVariant moveConstruct(QMetaType type, void *data);
    static QVariant copyConstruct(QMetaType type, const void *data);
 
    template<typename T>
    friend inline T qvariant_cast(const QVariant &);
    template<typename T>
    friend inline T qvariant_cast(QVariant &&);
 
protected:
    Private d;
    void create(int type, const void *copy);
    void create(QMetaType type, const void *copy);
    bool equals(const QVariant &other) const;
    bool convert(int type, void *ptr) const;
    bool view(int type, void *ptr);
 
private:
    // force compile error, prevent QVariant(bool) to be called
    inline QVariant(void *) = delete;
    // QVariant::Type is marked as \obsolete, but we don't want to
    // provide a constructor from its intended replacement,
    // QMetaType::Type, instead, because the idea behind these
    // constructors is flawed in the first place. But we also don't
    // want QVariant(QMetaType::String) to compile and falsely be an
    // int variant, so delete this constructor:
    QVariant(QMetaType::Type) = delete;
 
    // used to setup the QVariant internals for the "real" inplace ctor
    QVariant(std::in_place_t, QMetaType type);
    // helper for emplace
    void *prepareForEmplace(QMetaType type);
 
    // These constructors don't create QVariants of the type associated
    // with the enum, as expected, but they would create a QVariant of
    // type int with the value of the enum value.
    // Use QVariant v = QColor(Qt::red) instead of QVariant v = Qt::red for
    // example.
    QVariant(Qt::GlobalColor) = delete;
    QVariant(Qt::BrushStyle) = delete;
    QVariant(Qt::PenStyle) = delete;
    QVariant(Qt::CursorShape) = delete;
#ifdef QT_NO_CAST_FROM_ASCII
    // force compile error when implicit conversion is not wanted
    inline QVariant(const char *) = delete;
#endif
public:
    typedef Private DataPtr;
    inline DataPtr &data_ptr() { return d; }
    inline const DataPtr &data_ptr() const { return d; }
};
 
inline bool QVariant::isValid() const
{
    return d.type().isValid(QT6_CALL_NEW_OVERLOAD);
}
 
#ifndef QT_NO_DATASTREAM
Q_CORE_EXPORT QDataStream &operator>>(QDataStream &s, QVariant &p);
Q_CORE_EXPORT QDataStream &operator<<(QDataStream &s, const QVariant &p);
 
#if QT_DEPRECATED_SINCE(6, 0)
QT_WARNING_PUSH
QT_WARNING_DISABLE_DEPRECATED
QT_DEPRECATED_VERSION_6_0
inline QDataStream &operator>>(QDataStream &s, QVariant::Type &p)
{
    quint32 u;
    s >> u;
    p = static_cast<QVariant::Type>(u);
    return s;
}
QT_DEPRECATED_VERSION_6_0
inline QDataStream &operator<<(QDataStream &s, const QVariant::Type p)
{
    s << static_cast<quint32>(p);
    return s;
}
QT_WARNING_POP
#endif
 
#endif
 
#if QT_CORE_INLINE_IMPL_SINCE(6, 10)
QMetaType QVariant::metaType() const
{
    return d.type();
}
 
const char *QVariant::typeName() const
{
    return d.type().name();
}
#endif
 
inline bool QVariant::isDetached() const
{ return !d.is_shared || d.data.shared->ref.loadRelaxed() == 1; }
 
inline void swap(QVariant &value1, QVariant &value2) noexcept
{ value1.swap(value2); }
 
template<typename Indirect>
inline QVariant::ConstReference<Indirect>::ConstReference(const Reference<Indirect> &nonConst)
        noexcept(std::is_nothrow_copy_constructible_v<Indirect>)
    : ConstReference(nonConst.m_referred)
{
}
 
#ifndef QT_MOC
 
namespace QtPrivate {
template<typename T> inline T qvariant_cast_qmetatype_converted(const QVariant &v, QMetaType targetType)
{
    T t{};
    QMetaType::convert(v.metaType(), v.constData(), targetType, &t);
    return t;
}
} // namespace QtPrivate
 
template<typename T> inline T qvariant_cast(const QVariant &v)
{
    if (const T *ptr = get_if<T>(&v))
        return *ptr;
 
    QMetaType targetType = QMetaType::fromType<T>();
    return QtPrivate::qvariant_cast_qmetatype_converted<T>(v, targetType);
}
 
template<typename T> inline T qvariant_cast(QVariant &&v)
{
    if (const T *ptr = get_if<T>(&std::as_const(v))) {
        // we can only move from this if not sharing
        if constexpr (QVariant::Private::FitsInInternalSize<sizeof(T)>) {
            // If T in principle fits into the internal space, it may be using
            // it (depending on e.g. QTypeInfo, which, generally, can change
            // from version to version, so we need to check is_shared:
            if (!v.d.is_shared)
                return std::move(*const_cast<T *>(ptr));
        }
        // Otherwise, it cannot possibly be using internal space:
        Q_ASSERT(v.d.is_shared);
        if (v.d.data.shared->ref.loadRelaxed() == 1)
            return std::move(*const_cast<T *>(ptr));
        else
            return *ptr;
    }
    if constexpr (std::is_same_v<T, QVariant>) {
        // if the metatype doesn't match, but we want a QVariant, just return the current variant
        return v;
    }
 
    QMetaType targetType = QMetaType::fromType<T>();
    return QtPrivate::qvariant_cast_qmetatype_converted<T>(v, targetType);
}
 
#  ifndef QT_NO_VARIANT
template<> inline QVariant qvariant_cast<QVariant>(const QVariant &v)
{
    if (v.metaType().id() == QMetaType::QVariant)
        return *reinterpret_cast<const QVariant *>(v.constData());
    return v;
}
#  endif
 
#endif // QT_MOC
 
#ifndef QT_NO_DEBUG_STREAM
#if QT_DEPRECATED_SINCE(6, 0)
QT_WARNING_PUSH
QT_WARNING_DISABLE_DEPRECATED
QT_DEPRECATED_VERSION_6_0
Q_CORE_EXPORT QDebug operator<<(QDebug, const QVariant::Type);
QT_WARNING_POP
#endif
#endif
 
namespace QtPrivate {
class Q_CORE_EXPORT QVariantTypeCoercer
{
public:
    // ### Qt7: Pass QMetaType as value rather than const ref.
    const void *convert(const QVariant &value, const QMetaType &type);
    const void *coerce(const QVariant &value, const QMetaType &type);
 
private:
    QVariant converted;
};
}
 
#if QT_DEPRECATED_SINCE(6, 15)
QT_WARNING_PUSH
QT_WARNING_DISABLE_DEPRECATED
 
template<typename Pointer> class
QT_DEPRECATED_VERSION_X_6_15("Use QVariant::Reference instead.")
QVariantRef
{
private:
    const Pointer *m_pointer = nullptr;
 
public:
    explicit QVariantRef(const Pointer *reference) : m_pointer(reference) {}
    QVariantRef(const QVariantRef &) = default;
    QVariantRef(QVariantRef &&) = default;
    ~QVariantRef() = default;
 
    operator QVariant() const;
    QVariantRef &operator=(const QVariant &value);
    QVariantRef &operator=(const QVariantRef &value) { return operator=(QVariant(value)); }
    QVariantRef &operator=(QVariantRef &&value) { return operator=(QVariant(value)); }
 
    friend void swap(QVariantRef a, QVariantRef b)
    {
        QVariant tmp = a;
        a = b;
        b = std::move(tmp);
    }
};
 
// Keep this a single long line, otherwise syncqt doesn't create a class forwarding header
class Q_CORE_EXPORT QT_DEPRECATED_VERSION_X_6_15("Use QVariant::ConstPointer instead.") QVariantConstPointer
{
private:
    QVariant m_variant;
 
public:
    explicit QVariantConstPointer(QVariant variant);
 
    QVariant operator*() const;
    const QVariant *operator->() const;
};
 
template<typename Pointer> class
QT_DEPRECATED_VERSION_X_6_15("Use QVariant::Pointer instead.")
QVariantPointer
{
private:
    const Pointer *m_pointer = nullptr;
 
public:
    explicit QVariantPointer(const Pointer *pointer) : m_pointer(pointer) {}
    QVariantRef<Pointer> operator*() const { return QVariantRef<Pointer>(m_pointer); }
    Pointer operator->() const { return *m_pointer; }
};
 
QT_WARNING_POP
#endif // QT_DEPRECATED_SINCE(6, 15)
 
QT_END_NAMESPACE
 
#endif // QVARIANT_H