/**************************************************************************** ** ** Copyright (C) 2016 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$ ** ****************************************************************************/ #include "qmetatype.h" #include "qmetatype_p.h" #include "qobjectdefs.h" #include "qdatetime.h" #include "qbytearray.h" #include "qreadwritelock.h" #include "qstring.h" #include "qstringlist.h" #include "qlist.h" #include "qlocale.h" #include "qdebug.h" #if QT_CONFIG(easingcurve) #include "qeasingcurve.h" #endif #include "quuid.h" #include "qvariant.h" #include "qdatastream.h" #if QT_CONFIG(regularexpression) # include "qregularexpression.h" #endif #ifndef QT_BOOTSTRAPPED # include "qbitarray.h" # include "qurl.h" # include "qvariant.h" # include "qjsonvalue.h" # include "qjsonobject.h" # include "qjsonarray.h" # include "qjsondocument.h" # include "qcborvalue.h" # include "qcborarray.h" # include "qcbormap.h" # include "qbytearraylist.h" # include "qmetaobject.h" # include "qsequentialiterable.h" # include "qassociativeiterable.h" #endif #if QT_CONFIG(itemmodel) # include "qabstractitemmodel.h" #endif #ifndef QT_NO_GEOM_VARIANT # include "qsize.h" # include "qpoint.h" # include "qrect.h" # include "qline.h" #endif #include #include #include QT_BEGIN_NAMESPACE #define NS(x) QT_PREPEND_NAMESPACE(x) namespace { struct DefinedTypesFilter { template struct Acceptor { static const bool IsAccepted = QtMetaTypePrivate::TypeDefinition::IsAvailable && QModulesPrivate::QTypeModuleInfo::IsCore; }; }; struct QMetaTypeCustomRegistry { QReadWriteLock lock; QList registry; QHash aliases; // index of first empty (unregistered) type in registry, if any. int firstEmpty = 0; int registerCustomType(const QtPrivate::QMetaTypeInterface *ti) { { QWriteLocker l(&lock); if (ti->typeId) return ti->typeId; QByteArray name = #ifndef QT_NO_QOBJECT QMetaObject::normalizedType #endif (ti->name); if (auto ti2 = aliases.value(name)) { ti->typeId.storeRelaxed(ti2->typeId.loadRelaxed()); return ti2->typeId; } aliases[name] = ti; int size = registry.size(); while (firstEmpty < size && registry[firstEmpty]) ++firstEmpty; if (firstEmpty < size) { registry[firstEmpty] = ti; ++firstEmpty; } else { registry.append(ti); firstEmpty = registry.size(); } ti->typeId = firstEmpty + QMetaType::User; } if (ti->legacyRegisterOp) ti->legacyRegisterOp(); return ti->typeId; }; void unregisterDynamicType(int id) { if (!id) return; Q_ASSERT(id > QMetaType::User); QWriteLocker l(&lock); int idx = id - QMetaType::User - 1; auto &ti = registry[idx]; // We must unregister all names. auto it = aliases.begin(); while (it != aliases.end()) { if (it.value() == ti) it = aliases.erase(it); else ++it; } ti = nullptr; firstEmpty = std::min(firstEmpty, idx); } const QtPrivate::QMetaTypeInterface *getCustomType(int id) { QReadLocker l(&lock); return registry.value(id - QMetaType::User - 1); } }; Q_GLOBAL_STATIC(QMetaTypeCustomRegistry, customTypeRegistry) } // namespace /*! \macro Q_DECLARE_OPAQUE_POINTER(PointerType) \relates QMetaType \since 5.0 This macro enables pointers to forward-declared types (\a PointerType) to be registered with QMetaType using either Q_DECLARE_METATYPE() or qRegisterMetaType(). \sa Q_DECLARE_METATYPE(), qRegisterMetaType() */ /*! \macro Q_DECLARE_METATYPE(Type) \relates QMetaType This macro makes the type \a Type known to QMetaType as long as it provides a public default constructor, a public copy constructor and a public destructor. It is needed to use the type \a Type as a custom type in QVariant. This macro requires that \a Type is a fully defined type at the point where it is used. For pointer types, it also requires that the pointed to type is fully defined. Use in conjunction with Q_DECLARE_OPAQUE_POINTER() to register pointers to forward declared types. Ideally, this macro should be placed below the declaration of the class or struct. If that is not possible, it can be put in a private header file which has to be included every time that type is used in a QVariant. Adding a Q_DECLARE_METATYPE() makes the type known to all template based functions, including QVariant. Note that if you intend to use the type in \e queued signal and slot connections or in QObject's property system, you also have to call qRegisterMetaType() since the names are resolved at runtime. This example shows a typical use case of Q_DECLARE_METATYPE(): \snippet code/src_corelib_kernel_qmetatype.cpp 0 If \c MyStruct is in a namespace, the Q_DECLARE_METATYPE() macro has to be outside the namespace: \snippet code/src_corelib_kernel_qmetatype.cpp 1 Since \c{MyStruct} is now known to QMetaType, it can be used in QVariant: \snippet code/src_corelib_kernel_qmetatype.cpp 2 Some types are registered automatically and do not need this macro: \list \li Pointers to classes derived from QObject \li QList, QQueue, QStack or QSet where T is a registered meta type \li QHash, QMap or QPair where T1 and T2 are registered meta types \li QPointer, QSharedPointer, QWeakPointer, where T is a class that derives from QObject \li Enumerations registered with Q_ENUM or Q_FLAG \li Classes that have a Q_GADGET macro \endlist \note This method also registers the stream and debug operators for the type if they are visible at registration time. As this is done automatically in some places, it is strongly recommended to declare the stream operators for a type directly after the type itself. The stream operators should have the following signatures: \snippet code/src_corelib_kernel_qmetatype.cpp 6 \sa qRegisterMetaType() */ /*! \macro Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(Container) \relates QMetaType This macro makes the container \a Container known to QMetaType as a sequential container. This makes it possible to put an instance of Container into a QVariant, if T itself is known to QMetaType. Note that all of the Qt sequential containers already have built-in support, and it is not necessary to use this macro with them. The std::vector and std::list containers also have built-in support. This example shows a typical use of Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(): \snippet code/src_corelib_kernel_qmetatype.cpp 10 */ /*! \macro Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE(Container) \relates QMetaType This macro makes the container \a Container known to QMetaType as an associative container. This makes it possible to put an instance of Container into a QVariant, if T and U are themselves known to QMetaType. Note that all of the Qt associative containers already have built-in support, and it is not necessary to use this macro with them. The std::map container also has built-in support. This example shows a typical use of Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE(): \snippet code/src_corelib_kernel_qmetatype.cpp 11 */ /*! \macro Q_DECLARE_SMART_POINTER_METATYPE(SmartPointer) \relates QMetaType This macro makes the smart pointer \a SmartPointer known to QMetaType as a smart pointer. This makes it possible to put an instance of SmartPointer into a QVariant, if T is a type which inherits QObject. Note that the QWeakPointer, QSharedPointer and QPointer already have built-in support, and it is not necessary to use this macro with them. This example shows a typical use of Q_DECLARE_SMART_POINTER_METATYPE(): \snippet code/src_corelib_kernel_qmetatype.cpp 13 */ /*! \enum QMetaType::Type These are the built-in types supported by QMetaType: \value Void \c void \value Bool \c bool \value Int \c int \value UInt \c{unsigned int} \value Double \c double \value QChar QChar \value QString QString \value QByteArray QByteArray \value Nullptr \c{std::nullptr_t} \value VoidStar \c{void *} \value Long \c{long} \value LongLong LongLong \value Short \c{short} \value Char \c{char} \value Char16 \c{char16_t} \value Char32 \c{char32_t} \value ULong \c{unsigned long} \value ULongLong ULongLong \value UShort \c{unsigned short} \value SChar \c{signed char} \value UChar \c{unsigned char} \value Float \c float \value QObjectStar QObject * \value QVariant QVariant \value QCursor QCursor \value QDate QDate \value QSize QSize \value QTime QTime \value QVariantList QVariantList \value QPolygon QPolygon \value QPolygonF QPolygonF \value QColor QColor \value QColorSpace QColorSpace (introduced in Qt 5.15) \value QSizeF QSizeF \value QRectF QRectF \value QLine QLine \value QTextLength QTextLength \value QStringList QStringList \value QVariantMap QVariantMap \value QVariantHash QVariantHash \value QIcon QIcon \value QPen QPen \value QLineF QLineF \value QTextFormat QTextFormat \value QRect QRect \value QPoint QPoint \value QUrl QUrl \value QRegularExpression QRegularExpression \value QDateTime QDateTime \value QPointF QPointF \value QPalette QPalette \value QFont QFont \value QBrush QBrush \value QRegion QRegion \value QBitArray QBitArray \value QImage QImage \value QKeySequence QKeySequence \value QSizePolicy QSizePolicy \value QPixmap QPixmap \value QLocale QLocale \value QBitmap QBitmap \value QTransform QTransform \value QMatrix4x4 QMatrix4x4 \value QVector2D QVector2D \value QVector3D QVector3D \value QVector4D QVector4D \value QQuaternion QQuaternion \value QEasingCurve QEasingCurve \value QJsonValue QJsonValue \value QJsonObject QJsonObject \value QJsonArray QJsonArray \value QJsonDocument QJsonDocument \value QCborValue QCborValue \value QCborArray QCborArray \value QCborMap QCborMap \value QCborSimpleType QCborSimpleType \value QModelIndex QModelIndex \value QPersistentModelIndex QPersistentModelIndex (introduced in Qt 5.5) \value QUuid QUuid \value QByteArrayList QByteArrayList \value User Base value for user types \value UnknownType This is an invalid type id. It is returned from QMetaType for types that are not registered \omitvalue LastCoreType \omitvalue LastGuiType Additional types can be registered using Q_DECLARE_METATYPE(). \sa type(), typeName() */ /*! \enum QMetaType::TypeFlag The enum describes attributes of a type supported by QMetaType. \value NeedsConstruction This type has non-trivial constructors. If the flag is not set instances can be safely initialized with memset to 0. \value NeedsDestruction This type has a non-trivial destructor. If the flag is not set calls to the destructor are not necessary before discarding objects. \value ReloctableType An instance of a type having this attribute can be safely moved to a different memory location using memcpy. \omitvalue MovableType \omitvalue SharedPointerToQObject \value IsEnumeration This type is an enumeration. \value IsUnsignedEnumeration If the type is an Enumeration, its underlying type is unsigned. \value PointerToQObject This type is a pointer to a derived of QObject. \value IsPointer This type is a pointer to another type. \omitvalue WeakPointerToQObject \omitvalue TrackingPointerToQObject \omitvalue IsGadget \omit This type is a Q_GADGET and it's corresponding QMetaObject can be accessed with QMetaType::metaObject Since 5.5. \endomit \omitvalue PointerToGadget */ /*! \class QMetaType \inmodule QtCore \brief The QMetaType class manages named types in the meta-object system. \ingroup objectmodel \threadsafe The class is used as a helper to marshall types in QVariant and in queued signals and slots connections. It associates a type name to a type so that it can be created and destructed dynamically at run-time. Declare new types with Q_DECLARE_METATYPE() to make them available to QVariant and other template-based functions. Call qRegisterMetaType() to make types available to non-template based functions, such as the queued signal and slot connections. Any class or struct that has a public default constructor, a public copy constructor, and a public destructor can be registered. The following code allocates and destructs an instance of \c{MyClass}: \snippet code/src_corelib_kernel_qmetatype.cpp 3 If we want the stream operators \c operator<<() and \c operator>>() to work on QVariant objects that store custom types, the custom type must provide \c operator<<() and \c operator>>() operators. \sa Q_DECLARE_METATYPE(), QVariant::setValue(), QVariant::value(), QVariant::fromValue() */ /*! \fn bool QMetaType::isValid() const \since 5.0 Returns \c true if this QMetaType object contains valid information about a type, false otherwise. */ bool QMetaType::isValid() const { return d_ptr; } /*! \fn bool QMetaType::isRegistered() const \since 5.0 Returns \c true if this QMetaType object contains valid information about a type, false otherwise. */ bool QMetaType::isRegistered() const { return d_ptr; } /*! \fn int QMetaType::id() const \since 5.13 Returns id type hold by this QMetatype instance. */ int QMetaType::id() const { if (d_ptr) { if (d_ptr->typeId) return d_ptr->typeId; auto reg = customTypeRegistry(); if (reg) { return reg->registerCustomType(d_ptr); } } return 0; } /*! \fn constexpr bool QMetaType::sizeOf() const \since 5.0 Returns the size of the type in bytes (i.e. sizeof(T), where T is the actual type for which this QMetaType instance was constructed for). This function is typically used together with construct() to perform low-level management of the memory used by a type. \sa QMetaType::construct(), QMetaType::sizeOf(), QMetaType::alignOf() */ /*! \fn constexpr int QMetaType::alignOf() const \since 6.0 Returns the alignment of the type in bytes (i.e. alignof(T), where T is the actual type for which this QMetaType instance was constructed for). This function is typically used together with construct() to perform low-level management of the memory used by a type. \sa QMetaType::construct(), QMetaType::sizeOf() */ /*! \fn constexpr TypeFlags QMetaType::flags() const \since 5.0 Returns flags of the type for which this QMetaType instance was constructed. \sa QMetaType::TypeFlags, QMetaType::flags() */ /*! \fn constexpr const QMetaObject *QMetaType::metaObject() const \since 5.5 return a QMetaObject relative to this type. If the type is a pointer type to a subclass of QObject, flags() contains QMetaType::PointerToQObject and this function returns the corresponding QMetaObject. This can be used to in combinaison with QMetaObject::construct to create QObject of this type. If the type is a Q_GADGET, flags() contains QMetaType::IsGadget, and this function returns its QMetaObject. This can be used to retrieve QMetaMethod and QMetaProperty and use them on a pointer of this type. (given by QVariant::data for example) If the type is an enumeration, flags() contains QMetaType::IsEnumeration, and this function returns the QMetaObject of the enclosing object if the enum was registered as a Q_ENUM or \nullptr otherwise \sa QMetaType::flags() */ /*! \fn void *QMetaType::create(const void *copy = nullptr) const \since 5.0 Returns a copy of \a copy, assuming it is of the type that this QMetaType instance was created for. If \a copy is \nullptr, creates a default constructed instance. \sa QMetaType::destroy() */ void *QMetaType::create(const void *copy) const { if (d_ptr) { void *where = #ifdef __STDCPP_DEFAULT_NEW_ALIGNMENT__ d_ptr->alignment > __STDCPP_DEFAULT_NEW_ALIGNMENT__ ? operator new(d_ptr->size, std::align_val_t(d_ptr->alignment)) : #endif operator new(d_ptr->size); return construct(where, copy); } return nullptr; } /*! \fn void QMetaType::destroy(void *data) const \since 5.0 Destroys the \a data, assuming it is of the type that this QMetaType instance was created for. \sa QMetaType::create() */ void QMetaType::destroy(void *data) const { if (d_ptr && d_ptr->dtor) { d_ptr->dtor(d_ptr, data); if (d_ptr->alignment > __STDCPP_DEFAULT_NEW_ALIGNMENT__) { operator delete(data, std::align_val_t(d_ptr->alignment)); } else { operator delete(data); } } } /*! \fn void *QMetaType::construct(void *where, const void *copy = nullptr) const \since 5.0 Constructs a value of the type that this QMetaType instance was constructed for in the existing memory addressed by \a where, that is a copy of \a copy, and returns \a where. If \a copy is zero, the value is default constructed. This is a low-level function for explicitly managing the memory used to store the type. Consider calling create() if you don't need this level of control (that is, use "new" rather than "placement new"). You must ensure that \a where points to a location where the new value can be stored and that \a where is suitably aligned. The type's size can be queried by calling sizeOf(). The rule of thumb for alignment is that a type is aligned to its natural boundary, which is the smallest power of 2 that is bigger than the type, unless that alignment is larger than the maximum useful alignment for the platform. For practical purposes, alignment larger than 2 * sizeof(void*) is only necessary for special hardware instructions (e.g., aligned SSE loads and stores on x86). */ void *QMetaType::construct(void *where, const void *copy) const { if (!where) return nullptr; if (d_ptr) { if (copy && d_ptr->copyCtr) { d_ptr->copyCtr(d_ptr, where, copy); return where; } else if (!copy && d_ptr->defaultCtr) { d_ptr->defaultCtr(d_ptr, where); return where; } } return nullptr; } /*! \fn void QMetaType::destruct(void *data) const \since 5.0 Destructs the value, located at \a data, assuming that it is of the type for which this QMetaType instance was constructed for. Unlike destroy(), this function only invokes the type's destructor, it doesn't invoke the delete operator. \sa QMetaType::construct() */ void QMetaType::destruct(void *data) const { if (!data) return; if (d_ptr && d_ptr->dtor) { d_ptr->dtor(d_ptr, data); return; } } /*! Compares the objects at \a lhs and \a rhs for ordering. Returns an empty optional if comparison is not supported or the values are unordered. Otherwise, returns -1, 0 or +1 according as \a lhs is less than, equal to or greater than \a rhs. Both objects must be of the type described by this metatype. If either \a lhs or \a rhs is \nullptr, the values are unordered. Comparison is only supported if the type's less than operator was visible to the metatype declaration. If the type's equality operator was also visible, values will only compare equal if the equality operator says they are. In the absence of an equality operator, when neither value is less than the other, values are considered equal; if equality is also available and two such values are not equal, they are considered unordered, just as NaN (not a number) values of a floating point type lie outside its ordering. \note If no less than operator was visible to the metatype declaration, values are unordered even if an equality operator visible to the declaration considers them equal: \c{compare() == 0} only agrees with equals() if the less than operator was visible. \since 6.0 \sa equals(), isOrdered() */ std::optional QMetaType::compare(const void *lhs, const void *rhs) const { if (!lhs || !rhs) return std::optional{}; if (d_ptr->flags & QMetaType::IsPointer) return std::less()(*reinterpret_cast(lhs), *reinterpret_cast(rhs)); if (d_ptr && d_ptr->lessThan) { if (d_ptr->equals && d_ptr->equals(d_ptr, lhs, rhs)) return 0; if (d_ptr->lessThan(d_ptr, lhs, rhs)) return -1; if (d_ptr->lessThan(d_ptr, rhs, lhs)) return 1; if (!d_ptr->equals) return 0; } return std::optional{}; } /*! Compares the objects at \a lhs and \a rhs for equality. Both objects must be of the type described by this metatype. Can only compare the two objects if a less than or equality operator for the type was visible to the metatype declaration. Otherwise, the metatype never considers values equal. When an equality operator was visible to the metatype declaration, it is authoritative; otherwise, if less than is visible, when neither value is less than the other, the two are considered equal. If values are unordered (see compare() for details) they are not equal. Returns true if the two objects compare equal, otherwise false. \since 6.0 \sa isEqualityComparable(), compare() */ bool QMetaType::equals(const void *lhs, const void *rhs) const { if (!lhs || !rhs) return false; if (d_ptr) { if (d_ptr->flags & QMetaType::IsPointer) return *reinterpret_cast(lhs) == *reinterpret_cast(rhs); if (d_ptr->equals) return d_ptr->equals(d_ptr, lhs, rhs); if (d_ptr->lessThan && !d_ptr->lessThan(d_ptr, lhs, rhs) && !d_ptr->lessThan(d_ptr, rhs, lhs)) return true; } return false; } /*! Returns \c true if a less than or equality operator for the type described by this metatype was visible to the metatype declaration, otherwise \c false. \sa equals(), isOrdered() */ bool QMetaType::isEqualityComparable() const { return d_ptr && (d_ptr->flags & QMetaType::IsPointer || d_ptr->equals != nullptr || d_ptr->lessThan != nullptr); } /*! Returns \c true if a less than operator for the type described by this metatype was visible to the metatype declaration, otherwise \c false. \sa compare(), isEqualityComparable() */ bool QMetaType::isOrdered() const { return d_ptr && (d_ptr->flags & QMetaType::IsPointer || d_ptr->lessThan != nullptr); } /*! \internal */ void QMetaType::unregisterMetaType(QMetaType type) { if (type.d_ptr && type.d_ptr->typeId.loadRelaxed() >= QMetaType::User) { if (auto reg = customTypeRegistry()) reg->unregisterDynamicType(type.d_ptr->typeId.loadRelaxed()); type.d_ptr->typeId.storeRelease(0); } } /*! \fn template QMetaType QMetaType::fromType() \since 5.15 Returns the QMetaType corresponding to the type in the template parameter. */ /*! \fn bool QMetaType::operator==(QMetaType a, QMetaType b) \since 5.15 \overload Returns \c true if the QMetaType \a a represents the same type as the QMetaType \a b, otherwise returns \c false. */ /*! \fn bool QMetaType::operator!=(QMetaType a, QMetaType b) \since 5.15 \overload Returns \c true if the QMetaType \a a represents a different type than the QMetaType \a b, otherwise returns \c false. */ #define QT_ADD_STATIC_METATYPE(MetaTypeName, MetaTypeId, RealName) \ { #RealName, sizeof(#RealName) - 1, MetaTypeId }, #define QT_ADD_STATIC_METATYPE_ALIASES_ITER(MetaTypeName, MetaTypeId, AliasingName, RealNameStr) \ { RealNameStr, sizeof(RealNameStr) - 1, QMetaType::MetaTypeName }, static const struct { const char * typeName; int typeNameLength; int type; } types[] = { QT_FOR_EACH_STATIC_TYPE(QT_ADD_STATIC_METATYPE) QT_FOR_EACH_STATIC_ALIAS_TYPE(QT_ADD_STATIC_METATYPE_ALIASES_ITER) QT_ADD_STATIC_METATYPE(_, QMetaTypeId2::MetaType, qreal) {nullptr, 0, QMetaType::UnknownType} }; static const struct : QMetaTypeModuleHelper { template, QLatin1String, const char *>> static inline bool convertToBool(const T &source) { T str = source.toLower(); return !(str.isEmpty() || str == LiteralWrapper("0") || str == LiteralWrapper("false")); } const QtPrivate::QMetaTypeInterface *interfaceForType(int type) const override { switch (type) { QT_FOR_EACH_STATIC_PRIMITIVE_TYPE(QT_METATYPE_CONVERT_ID_TO_TYPE) QT_FOR_EACH_STATIC_PRIMITIVE_POINTER(QT_METATYPE_CONVERT_ID_TO_TYPE) QT_FOR_EACH_STATIC_CORE_CLASS(QT_METATYPE_CONVERT_ID_TO_TYPE) QT_FOR_EACH_STATIC_CORE_POINTER(QT_METATYPE_CONVERT_ID_TO_TYPE) QT_FOR_EACH_STATIC_CORE_TEMPLATE(QT_METATYPE_CONVERT_ID_TO_TYPE) default: return nullptr; } } bool convert(const void *from, int fromTypeId, void *to, int toTypeId) const override { Q_ASSERT(fromTypeId != toTypeId); bool onlyCheck = (from == nullptr && to == nullptr); using Char = char; using SChar = signed char; using UChar = unsigned char; using Short = short; using UShort = unsigned short; using Int = int; using UInt = unsigned int; using Long = long; using LongLong = qlonglong; using ULong = unsigned long; using ULongLong = qulonglong; using Float = float; using Double = double; using Bool = bool; using Nullptr = std::nullptr_t; #define QMETATYPE_CONVERTER_ASSIGN_DOUBLE(To, From) \ QMETATYPE_CONVERTER(To, From, result = double(source); return true;) #define QMETATYPE_CONVERTER_ASSIGN_NUMBER(To, From) \ QMETATYPE_CONVERTER(To, From, result = To::number(source); return true;) #ifndef QT_BOOTSTRAPPED #define CONVERT_CBOR_AND_JSON(To) \ QMETATYPE_CONVERTER(To, QCborValue, \ if constexpr(std::is_same_v) { \ if (!source.isBool()) \ return false; \ result = source.toBool(); \ } else { \ if (!source.isInteger() && !source.isDouble()) \ return false; \ if constexpr(std::is_integral_v) \ result = source.toInteger(); \ else \ result = source.toDouble(); \ } \ return true; \ ); \ QMETATYPE_CONVERTER(To, QJsonValue, \ if constexpr(std::is_same_v) { \ if (!source.isBool()) \ return false; \ result = source.toBool(); \ } else { \ if (!source.isDouble()) \ return false; \ if constexpr(std::is_integral_v) \ result = source.toInteger(); \ else \ result = source.toDouble(); \ } \ return true; \ ) #else #define CONVERT_CBOR_AND_JSON(To) #endif #define INTEGRAL_CONVERTER(To) \ QMETATYPE_CONVERTER_ASSIGN(To, Bool); \ QMETATYPE_CONVERTER_ASSIGN(To, Char); \ QMETATYPE_CONVERTER_ASSIGN(To, UChar); \ QMETATYPE_CONVERTER_ASSIGN(To, SChar); \ QMETATYPE_CONVERTER_ASSIGN(To, Short); \ QMETATYPE_CONVERTER_ASSIGN(To, UShort); \ QMETATYPE_CONVERTER_ASSIGN(To, Int); \ QMETATYPE_CONVERTER_ASSIGN(To, UInt); \ QMETATYPE_CONVERTER_ASSIGN(To, Long); \ QMETATYPE_CONVERTER_ASSIGN(To, ULong); \ QMETATYPE_CONVERTER_ASSIGN(To, LongLong); \ QMETATYPE_CONVERTER_ASSIGN(To, ULongLong); \ QMETATYPE_CONVERTER(To, Float, result = qRound64(source); return true;); \ QMETATYPE_CONVERTER(To, Double, result = qRound64(source); return true;); \ QMETATYPE_CONVERTER(To, QChar, result = source.unicode(); return true;); \ QMETATYPE_CONVERTER(To, QString, \ bool ok = false; \ if constexpr(std::is_same_v) \ result = (ok = true, convertToBool(source)); \ else if constexpr(std::is_signed_v) \ result = To(source.toLongLong(&ok)); \ else \ result = To(source.toULongLong(&ok)); \ return ok; \ ); \ QMETATYPE_CONVERTER(To, QByteArray, \ bool ok = false; \ if constexpr(std::is_same_v) \ result = (ok = true, convertToBool(source)); \ else if constexpr(std::is_signed_v) \ result = To(source.toLongLong(&ok)); \ else \ result = To(source.toULongLong(&ok)); \ return ok; \ ); \ CONVERT_CBOR_AND_JSON(To) #define FLOAT_CONVERTER(To) \ QMETATYPE_CONVERTER_ASSIGN(To, Bool); \ QMETATYPE_CONVERTER_ASSIGN(To, Char); \ QMETATYPE_CONVERTER_ASSIGN(To, UChar); \ QMETATYPE_CONVERTER_ASSIGN(To, SChar); \ QMETATYPE_CONVERTER_ASSIGN(To, Short); \ QMETATYPE_CONVERTER_ASSIGN(To, UShort); \ QMETATYPE_CONVERTER_ASSIGN(To, Int); \ QMETATYPE_CONVERTER_ASSIGN(To, UInt); \ QMETATYPE_CONVERTER_ASSIGN(To, Long); \ QMETATYPE_CONVERTER_ASSIGN(To, ULong); \ QMETATYPE_CONVERTER_ASSIGN(To, LongLong); \ QMETATYPE_CONVERTER_ASSIGN(To, ULongLong); \ QMETATYPE_CONVERTER_ASSIGN(To, Float); \ QMETATYPE_CONVERTER_ASSIGN(To, Double); \ QMETATYPE_CONVERTER(To, QString, \ bool ok = false; \ result = source.toDouble(&ok); \ return ok; \ ); \ QMETATYPE_CONVERTER(To, QByteArray, \ bool ok = false; \ result = source.toDouble(&ok); \ return ok; \ ); \ CONVERT_CBOR_AND_JSON(To) switch (makePair(toTypeId, fromTypeId)) { // integral conversions INTEGRAL_CONVERTER(Bool); INTEGRAL_CONVERTER(Char); INTEGRAL_CONVERTER(UChar); INTEGRAL_CONVERTER(SChar); INTEGRAL_CONVERTER(Short); INTEGRAL_CONVERTER(UShort); INTEGRAL_CONVERTER(Int); INTEGRAL_CONVERTER(UInt); INTEGRAL_CONVERTER(Long); INTEGRAL_CONVERTER(ULong); INTEGRAL_CONVERTER(LongLong); INTEGRAL_CONVERTER(ULongLong); FLOAT_CONVERTER(Float); FLOAT_CONVERTER(Double); #ifndef QT_BOOTSTRAPPED QMETATYPE_CONVERTER_ASSIGN(QUrl, QString); QMETATYPE_CONVERTER(QUrl, QCborValue, if (source.isUrl()) { result = source.toUrl(); return true; } return false; ); #endif #if QT_CONFIG(itemmodel) QMETATYPE_CONVERTER_ASSIGN(QModelIndex, QPersistentModelIndex); QMETATYPE_CONVERTER_ASSIGN(QPersistentModelIndex, QModelIndex); #endif // QT_CONFIG(itemmodel) // QChar methods #define QMETATYPE_CONVERTER_ASSIGN_QCHAR(From) \ QMETATYPE_CONVERTER(QChar, From, result = QChar::fromUcs2(source); return true;) QMETATYPE_CONVERTER_ASSIGN_QCHAR(Char); QMETATYPE_CONVERTER_ASSIGN_QCHAR(SChar); QMETATYPE_CONVERTER_ASSIGN_QCHAR(Short); QMETATYPE_CONVERTER_ASSIGN_QCHAR(Long); QMETATYPE_CONVERTER_ASSIGN_QCHAR(Int); QMETATYPE_CONVERTER_ASSIGN_QCHAR(LongLong); QMETATYPE_CONVERTER_ASSIGN_QCHAR(Float); QMETATYPE_CONVERTER_ASSIGN_QCHAR(UChar); QMETATYPE_CONVERTER_ASSIGN_QCHAR(UShort); QMETATYPE_CONVERTER_ASSIGN_QCHAR(ULong); QMETATYPE_CONVERTER_ASSIGN_QCHAR(UInt); QMETATYPE_CONVERTER_ASSIGN_QCHAR(ULongLong); // conversions to QString QMETATYPE_CONVERTER_ASSIGN(QString, QChar); QMETATYPE_CONVERTER(QString, Bool, result = source ? QStringLiteral("true") : QStringLiteral("false"); return true; ); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, Short); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, Long); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, Int); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, LongLong); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, UShort); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, ULong); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, UInt); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QString, ULongLong); QMETATYPE_CONVERTER(QString, Float, result = QString::number(source, 'g', QLocale::FloatingPointShortest); return true; ); QMETATYPE_CONVERTER(QString, Double, result = QString::number(source, 'g', QLocale::FloatingPointShortest); return true; ); QMETATYPE_CONVERTER(QString, Char, result = QString::fromLatin1(&source, 1); return true; ); QMETATYPE_CONVERTER(QString, SChar, char s = source; result = QString::fromLatin1(&s, 1); return true; ); QMETATYPE_CONVERTER(QString, UChar, char s = source; result = QString::fromLatin1(&s, 1); return true; ); #if QT_CONFIG(datestring) QMETATYPE_CONVERTER(QString, QDate, result = source.toString(Qt::ISODate); return true;); QMETATYPE_CONVERTER(QString, QTime, result = source.toString(Qt::ISODateWithMs); return true;); QMETATYPE_CONVERTER(QString, QDateTime, result = source.toString(Qt::ISODateWithMs); return true;); #endif QMETATYPE_CONVERTER(QString, QByteArray, result = QString::fromUtf8(source); return true;); QMETATYPE_CONVERTER(QString, QStringList, return (source.count() == 1) ? (result = source.at(0), true) : false; ); #ifndef QT_BOOTSTRAPPED QMETATYPE_CONVERTER(QString, QUrl, result = source.toString(); return true;); QMETATYPE_CONVERTER(QString, QJsonValue, if (source.isString() || source.isNull()) { result = source.toString(); return true; } return false; ); #endif QMETATYPE_CONVERTER(QString, Nullptr, Q_UNUSED(source); result = QString(); return true;); // QByteArray QMETATYPE_CONVERTER(QByteArray, QString, result = source.toUtf8(); return true;); QMETATYPE_CONVERTER(QByteArray, Bool, result = source ? "true" : "false"; return true; ); QMETATYPE_CONVERTER(QByteArray, Char, result = QByteArray(source, 1); return true;); QMETATYPE_CONVERTER(QByteArray, SChar, result = QByteArray(source, 1); return true;); QMETATYPE_CONVERTER(QByteArray, UChar, result = QByteArray(source, 1); return true;); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, Short); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, Long); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, Int); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, LongLong); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, UShort); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, ULong); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, UInt); QMETATYPE_CONVERTER_ASSIGN_NUMBER(QByteArray, ULongLong); QMETATYPE_CONVERTER(QByteArray, Float, result = QByteArray::number(source, 'g', QLocale::FloatingPointShortest); return true; ); QMETATYPE_CONVERTER(QByteArray, Double, result = QByteArray::number(source, 'g', QLocale::FloatingPointShortest); return true; ); QMETATYPE_CONVERTER(QByteArray, Nullptr, Q_UNUSED(source); result = QByteArray(); return true;); QMETATYPE_CONVERTER(QString, QUuid, result = source.toString(); return true;); QMETATYPE_CONVERTER(QUuid, QString, result = QUuid(source); return true;); QMETATYPE_CONVERTER(QByteArray, QUuid, result = source.toByteArray(); return true;); QMETATYPE_CONVERTER(QUuid, QByteArray, result = QUuid(source); return true;); #ifndef QT_NO_GEOM_VARIANT QMETATYPE_CONVERTER(QSize, QSizeF, result = source.toSize(); return true;); QMETATYPE_CONVERTER_ASSIGN(QSizeF, QSize); QMETATYPE_CONVERTER(QLine, QLineF, result = source.toLine(); return true;); QMETATYPE_CONVERTER_ASSIGN(QLineF, QLine); QMETATYPE_CONVERTER(QRect, QRectF, result = source.toRect(); return true;); QMETATYPE_CONVERTER_ASSIGN(QRectF, QRect); QMETATYPE_CONVERTER(QPoint, QPointF, result = source.toPoint(); return true;); QMETATYPE_CONVERTER_ASSIGN(QPointF, QPoint); #endif QMETATYPE_CONVERTER(QByteArrayList, QVariantList, result.reserve(source.size()); for (auto v: source) result.append(v.toByteArray()); return true; ); QMETATYPE_CONVERTER(QVariantList, QByteArrayList, result.reserve(source.size()); for (auto v: source) result.append(QVariant(v)); return true; ); QMETATYPE_CONVERTER(QStringList, QVariantList, result.reserve(source.size()); for (auto v: source) result.append(v.toString()); return true; ); QMETATYPE_CONVERTER(QVariantList, QStringList, result.reserve(source.size()); for (auto v: source) result.append(QVariant(v)); return true; ); QMETATYPE_CONVERTER(QStringList, QString, result = QStringList() << source; return true;); QMETATYPE_CONVERTER(QVariantHash, QVariantMap, for (auto it = source.begin(); it != source.end(); ++it) result.insert(it.key(), it.value()); return true; ); QMETATYPE_CONVERTER(QVariantMap, QVariantHash, for (auto it = source.begin(); it != source.end(); ++it) result.insert(it.key(), it.value()); return true; ); #ifndef QT_BOOTSTRAPPED QMETATYPE_CONVERTER_ASSIGN(QCborValue, QString); QMETATYPE_CONVERTER(QString, QCborValue, if (source.isContainer() || source.isTag()) return false; result = source.toVariant().toString(); return true; ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QByteArray); QMETATYPE_CONVERTER(QByteArray, QCborValue, if (source.isByteArray()) { result = source.toByteArray(); return true; } return false; ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QUuid); QMETATYPE_CONVERTER(QUuid, QCborValue, if (!source.isUuid()) return false; result = source.toUuid(); return true; ); QMETATYPE_CONVERTER(QCborValue, QVariantList, result = QCborArray::fromVariantList(source); return true;); QMETATYPE_CONVERTER(QVariantList, QCborValue, if (!source.isArray()) return false; result = source.toArray().toVariantList(); return true; ); QMETATYPE_CONVERTER(QCborValue, QVariantMap, result = QCborMap::fromVariantMap(source); return true;); QMETATYPE_CONVERTER(QVariantMap, QCborValue, if (!source.isMap()) return false; result = source.toMap().toVariantMap(); return true; ); QMETATYPE_CONVERTER(QCborValue, QVariantHash, result = QCborMap::fromVariantHash(source); return true;); QMETATYPE_CONVERTER(QVariantHash, QCborValue, if (!source.isMap()) return false; result = source.toMap().toVariantHash(); return true; ); #if QT_CONFIG(regularexpression) QMETATYPE_CONVERTER(QCborValue, QRegularExpression, result = QCborValue(source); return true;); QMETATYPE_CONVERTER(QRegularExpression, QCborValue, if (!source.isRegularExpression()) return false; result = source.toRegularExpression(); return true; ); #endif QMETATYPE_CONVERTER(QCborValue, Nullptr, Q_UNUSED(source); result = QCborValue(QCborValue::Null); return true; ); QMETATYPE_CONVERTER(Nullptr, QCborValue, result = nullptr; return source.isNull(); ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Bool); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Int); QMETATYPE_CONVERTER_ASSIGN(QCborValue, UInt); QMETATYPE_CONVERTER(QCborValue, ULong, result = qlonglong(source); return true;); QMETATYPE_CONVERTER(QCborValue, Long, result = qlonglong(source); return true;); QMETATYPE_CONVERTER_ASSIGN(QCborValue, LongLong); QMETATYPE_CONVERTER(QCborValue, ULongLong, result = qlonglong(source); return true;); QMETATYPE_CONVERTER_ASSIGN(QCborValue, UShort); QMETATYPE_CONVERTER_ASSIGN(QCborValue, UChar); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Char); QMETATYPE_CONVERTER_ASSIGN(QCborValue, SChar); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Short); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Double); QMETATYPE_CONVERTER_ASSIGN(QCborValue, Float); QMETATYPE_CONVERTER(QCborValue, QStringList, result = QCborArray::fromStringList(source); return true; ); QMETATYPE_CONVERTER(QCborValue, QDate, result = QCborValue(source.startOfDay()); return true; ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QUrl); QMETATYPE_CONVERTER(QCborValue, QJsonValue, result = QCborValue::fromJsonValue(source); return true; ); QMETATYPE_CONVERTER(QCborValue, QJsonObject, result = QCborMap::fromJsonObject(source); return true; ); QMETATYPE_CONVERTER(QCborValue, QJsonArray, result = QCborArray::fromJsonArray(source); return true; ); QMETATYPE_CONVERTER(QCborValue, QJsonDocument, QJsonDocument doc = source; if (doc.isArray()) result = QCborArray::fromJsonArray(doc.array()); else result = QCborMap::fromJsonObject(doc.object()); return true; ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QCborMap); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QCborArray); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QDateTime); QMETATYPE_CONVERTER(QDateTime, QCborValue, if (source.isDateTime()) { result = source.toDateTime(); return true; } return false; ); QMETATYPE_CONVERTER_ASSIGN(QCborValue, QCborSimpleType); QMETATYPE_CONVERTER(QCborSimpleType, QCborValue, if (source.isSimpleType()) { result = source.toSimpleType(); return true; } return false; ); QMETATYPE_CONVERTER(QCborArray, QVariantList, result = QCborArray::fromVariantList(source); return true;); QMETATYPE_CONVERTER(QVariantList, QCborArray, result = source.toVariantList(); return true;); QMETATYPE_CONVERTER(QCborArray, QStringList, result = QCborArray::fromStringList(source); return true;); QMETATYPE_CONVERTER(QCborMap, QVariantMap, result = QCborMap::fromVariantMap(source); return true;); QMETATYPE_CONVERTER(QVariantMap, QCborMap, result = source.toVariantMap(); return true;); QMETATYPE_CONVERTER(QCborMap, QVariantHash, result = QCborMap::fromVariantHash(source); return true;); QMETATYPE_CONVERTER(QVariantHash, QCborMap, result = source.toVariantHash(); return true;); QMETATYPE_CONVERTER(QCborArray, QCborValue, if (!source.isArray()) return false; result = source.toArray(); return true; ); QMETATYPE_CONVERTER(QCborArray, QJsonDocument, if (!source.isArray()) return false; result = QCborArray::fromJsonArray(source.array()); return true; ); QMETATYPE_CONVERTER(QCborArray, QJsonValue, if (!source.isArray()) return false; result = QCborArray::fromJsonArray(source.toArray()); return true; ); QMETATYPE_CONVERTER(QCborArray, QJsonArray, result = QCborArray::fromJsonArray(source); return true; ); QMETATYPE_CONVERTER(QCborMap, QCborValue, if (!source.isMap()) return false; result = source.toMap(); return true; ); QMETATYPE_CONVERTER(QCborMap, QJsonDocument, if (source.isArray()) return false; result = QCborMap::fromJsonObject(source.object()); return true; ); QMETATYPE_CONVERTER(QCborMap, QJsonValue, if (!source.isObject()) return false; result = QCborMap::fromJsonObject(source.toObject()); return true; ); QMETATYPE_CONVERTER(QCborMap, QJsonObject, result = QCborMap::fromJsonObject(source); return true; ); QMETATYPE_CONVERTER(QVariantList, QJsonValue, if (!source.isArray()) return false; result = source.toArray().toVariantList(); return true; ); QMETATYPE_CONVERTER(QVariantList, QJsonArray, result = source.toVariantList(); return true;); QMETATYPE_CONVERTER(QVariantMap, QJsonValue, if (!source.isObject()) return false; result = source.toObject().toVariantMap(); return true; ); QMETATYPE_CONVERTER(QVariantMap, QJsonObject, result = source.toVariantMap(); return true;); QMETATYPE_CONVERTER(QVariantHash, QJsonValue, if (!source.isObject()) return false; result = source.toObject().toVariantHash(); return true; ); QMETATYPE_CONVERTER(QVariantHash, QJsonObject, result = source.toVariantHash(); return true;); QMETATYPE_CONVERTER(QJsonArray, QStringList, result = QJsonArray::fromStringList(source); return true;); QMETATYPE_CONVERTER(QJsonArray, QVariantList, result = QJsonArray::fromVariantList(source); return true;); QMETATYPE_CONVERTER(QJsonArray, QJsonValue, if (!source.isArray()) return false; result = source.toArray(); return true; ); QMETATYPE_CONVERTER(QJsonArray, QJsonDocument, if (!source.isArray()) return false; result = source.array(); return true; ); QMETATYPE_CONVERTER(QJsonArray, QCborValue, if (!source.isArray()) return false; result = source.toArray().toJsonArray(); return true; ); QMETATYPE_CONVERTER(QJsonArray, QCborArray, result = source.toJsonArray(); return true;); QMETATYPE_CONVERTER(QJsonObject, QVariantMap, result = QJsonObject::fromVariantMap(source); return true;); QMETATYPE_CONVERTER(QJsonObject, QVariantHash, result = QJsonObject::fromVariantHash(source); return true;); QMETATYPE_CONVERTER(QJsonObject, QJsonValue, if (!source.isObject()) return false; result = source.toObject(); return true; ); QMETATYPE_CONVERTER(QJsonObject, QJsonDocument, if (source.isArray()) return false; result = source.object(); return true; ); QMETATYPE_CONVERTER(QJsonObject, QCborValue, if (!source.isMap()) return false; result = source.toMap().toJsonObject(); return true; ); QMETATYPE_CONVERTER(QJsonObject, QCborMap, result = source.toJsonObject(); return true; ); QMETATYPE_CONVERTER(QJsonValue, Nullptr, Q_UNUSED(source); result = QJsonValue(QJsonValue::Null); return true; ); QMETATYPE_CONVERTER(Nullptr, QJsonValue, result = nullptr; return source.isNull(); ); QMETATYPE_CONVERTER(QJsonValue, Bool, result = QJsonValue(source); return true;); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Int); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, UInt); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Double); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Float); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, ULong); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Long); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, LongLong); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, ULongLong); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, UShort); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, UChar); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Char); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, SChar); QMETATYPE_CONVERTER_ASSIGN_DOUBLE(QJsonValue, Short); QMETATYPE_CONVERTER_ASSIGN(QJsonValue, QString); QMETATYPE_CONVERTER(QJsonValue, QStringList, result = QJsonValue(QJsonArray::fromStringList(source)); return true; ); QMETATYPE_CONVERTER(QJsonValue, QVariantList, result = QJsonValue(QJsonArray::fromVariantList(source)); return true; ); QMETATYPE_CONVERTER(QJsonValue, QVariantMap, result = QJsonValue(QJsonObject::fromVariantMap(source)); return true; ); QMETATYPE_CONVERTER(QJsonValue, QVariantHash, result = QJsonValue(QJsonObject::fromVariantHash(source)); return true; ); QMETATYPE_CONVERTER(QJsonValue, QJsonObject, result = source; return true; ); QMETATYPE_CONVERTER(QJsonValue, QJsonArray, result = source; return true; ); QMETATYPE_CONVERTER(QJsonValue, QJsonDocument, QJsonDocument doc = source; result = doc.isArray() ? QJsonValue(doc.array()) : QJsonValue(doc.object()); return true; ); QMETATYPE_CONVERTER(QJsonValue, QCborValue, result = source.toJsonValue(); return true; ); QMETATYPE_CONVERTER(QJsonValue, QCborMap, result = source.toJsonObject(); return true; ); QMETATYPE_CONVERTER(QJsonValue, QCborArray, result = source.toJsonArray(); return true; ); #endif QMETATYPE_CONVERTER(QDate, QDateTime, result = source.date(); return true;); QMETATYPE_CONVERTER(QTime, QDateTime, result = source.time(); return true;); QMETATYPE_CONVERTER(QDateTime, QDate, result = source.startOfDay(); return true;); #if QT_CONFIG(datestring) QMETATYPE_CONVERTER(QDate, QString, result = QDate::fromString(source, Qt::ISODate); return result.isValid(); ); QMETATYPE_CONVERTER(QTime, QString, result = QTime::fromString(source, Qt::ISODate); return result.isValid(); ); QMETATYPE_CONVERTER(QDateTime, QString, result = QDateTime::fromString(source, Qt::ISODate); return result.isValid(); ); #endif } return false; } } metatypeHelper; static const QMetaTypeModuleHelper *qMetaTypeCoreHelper = &metatypeHelper; Q_CORE_EXPORT const QMetaTypeModuleHelper *qMetaTypeGuiHelper = nullptr; Q_CORE_EXPORT const QMetaTypeModuleHelper *qMetaTypeWidgetsHelper = nullptr; static const QMetaTypeModuleHelper *qModuleHelperForType(int type) { if (type <= QMetaType::LastCoreType) return qMetaTypeCoreHelper; if (type >= QMetaType::FirstGuiType && type <= QMetaType::LastGuiType) return qMetaTypeGuiHelper; else if (type >= QMetaType::FirstWidgetsType && type <= QMetaType::LastWidgetsType) return qMetaTypeWidgetsHelper; return nullptr; } template class QMetaTypeFunctionRegistry { public: ~QMetaTypeFunctionRegistry() { const QWriteLocker locker(&lock); map.clear(); } bool contains(Key k) const { const QReadLocker locker(&lock); return map.contains(k); } bool insertIfNotContains(Key k, const T &f) { const QWriteLocker locker(&lock); if (map.contains(k)) return false; map.insert(k, f); return true; } const T *function(Key k) const { const QReadLocker locker(&lock); auto it = map.find(k); return it == map.end() ? nullptr : std::addressof(*it); } void remove(int from, int to) { const Key k(from, to); const QWriteLocker locker(&lock); map.remove(k); } private: mutable QReadWriteLock lock; QHash map; }; typedef QMetaTypeFunctionRegistry > QMetaTypeConverterRegistry; Q_GLOBAL_STATIC(QMetaTypeConverterRegistry, customTypesConversionRegistry) using QMetaTypeMutableViewRegistry = QMetaTypeFunctionRegistry>; Q_GLOBAL_STATIC(QMetaTypeMutableViewRegistry, customTypesMutableViewRegistry) /*! \fn bool QMetaType::registerConverter() \since 5.2 Registers the possibility of an implicit conversion from type From to type To in the meta type system. Returns \c true if the registration succeeded, otherwise false. */ /*! \fn template bool QMetaType::registerConverter(MemberFunction function) \since 5.2 \overload Registers a method \a function like To From::function() const as converter from type From to type To in the meta type system. Returns \c true if the registration succeeded, otherwise false. */ /*! \fn template bool QMetaType::registerConverter(MemberFunctionOk function) \since 5.2 \overload Registers a method \a function like To From::function(bool *ok) const as converter from type From to type To in the meta type system. Returns \c true if the registration succeeded, otherwise false. */ /*! \fn template bool QMetaType::registerConverter(UnaryFunction function) \since 5.2 \overload Registers a unary function object \a function as converter from type From to type To in the meta type system. Returns \c true if the registration succeeded, otherwise false. */ /*! Registers function \a f as converter function from type id \a from to \a to. If there's already a conversion registered, this does nothing but deleting \a f. Returns \c true if the registration succeeded, otherwise false. \since 5.2 \internal */ bool QMetaType::registerConverterFunction(const ConverterFunction &f, QMetaType from, QMetaType to) { if (!customTypesConversionRegistry()->insertIfNotContains(qMakePair(from.id(), to.id()), f)) { qWarning("Type conversion already registered from type %s to type %s", from.name(), to.name()); return false; } return true; } /*! \fn template bool QMetaType::registerMutableView(MemberFunction function) \since 6.0 \overload Registers a method \a function like \c {To From::function()} as mutable view of type \c {To} on type \c {From} in the meta type system. Returns \c true if the registration succeeded, otherwise \c false. */ /*! \fn template bool QMetaType::registerMutableView(MemberFunctionOk function) \since 6.0 \overload Registers a method \a function like To From::function(bool *ok) as mutable view of type To on type From in the meta type system. Returns \c true if the registration succeeded, otherwise \c false. */ /*! \fn template bool QMetaType::registerMutableView(UnaryFunction function) \since 6.0 \overload Registers a unary function object \a function as mutable view of type To on type From in the meta type system. Returns \c true if the registration succeeded, otherwise \c false. */ /*! Registers function \a f as mutable view of type id \a to on type id \a from. Returns \c true if the registration succeeded, otherwise \c false. \since 6.0 \internal */ bool QMetaType::registerMutableViewFunction(const MutableViewFunction &f, QMetaType from, QMetaType to) { if (!customTypesMutableViewRegistry()->insertIfNotContains(qMakePair(from.id(), to.id()), f)) { qWarning("Mutable view on type already registered from type %s to type %s", from.name(), to.name()); return false; } return true; } /*! \internal */ void QMetaType::unregisterMutableViewFunction(QMetaType from, QMetaType to) { if (customTypesMutableViewRegistry.isDestroyed()) return; customTypesMutableViewRegistry()->remove(from.id(), to.id()); } /*! \internal Invoked automatically when a converter function object is destroyed. */ void QMetaType::unregisterConverterFunction(QMetaType from, QMetaType to) { if (customTypesConversionRegistry.isDestroyed()) return; customTypesConversionRegistry()->remove(from.id(), to.id()); } #ifndef QT_NO_DEBUG_STREAM /*! Streams the object at \a rhs to the debug stream \a dbg. Returns \c true on success, otherwise false. \since 5.2 */ bool QMetaType::debugStream(QDebug& dbg, const void *rhs) { if (d_ptr && d_ptr->flags & QMetaType::IsPointer) { dbg << *reinterpret_cast(rhs); return true; } if (d_ptr && d_ptr->debugStream) { d_ptr->debugStream(d_ptr, dbg, rhs); return true; } return false; } /*! \fn bool QMetaType::debugStream(QDebug& dbg, const void *rhs, int typeId) \overload \obsolete */ /*! \fn bool QMetaType::hasRegisteredDebugStreamOperator() \obsolete \since 5.2 Returns \c true, if the meta type system has a registered debug stream operator for type T. */ /*! \fn bool QMetaType::hasRegisteredDebugStreamOperator(int typeId) \obsolete Use QMetaType::hasRegisteredDebugStreamOperator() instead. Returns \c true, if the meta type system has a registered debug stream operator for type id \a typeId. \since 5.2 */ /*! \since 6.0 Returns \c true, if the meta type system has a registered debug stream operator for this meta type. */ bool QMetaType::hasRegisteredDebugStreamOperator() const { return d_ptr && d_ptr->debugStream != nullptr; } #endif #ifndef QT_NO_QOBJECT /*! \internal returns a QMetaEnum for a given meta tape type id if possible */ static QMetaEnum metaEnumFromType(QMetaType t) { if (t.flags() & QMetaType::IsEnumeration) { if (const QMetaObject *metaObject = t.metaObject()) { const QByteArray enumName = t.name(); const char *lastColon = std::strrchr(enumName, ':'); return metaObject->enumerator(metaObject->indexOfEnumerator( lastColon ? lastColon + 1 : enumName.constData())); } } return QMetaEnum(); } #endif static bool convertFromEnum(QMetaType fromType, const void *from, QMetaType toType, void *to) { qlonglong ll; if (fromType.flags() & QMetaType::IsUnsignedEnumeration) { qulonglong ull; switch (fromType.sizeOf()) { case 1: ull = *static_cast(from); break; case 2: ull = *static_cast(from); break; case 4: ull = *static_cast(from); break; case 8: ull = *static_cast(from); break; default: Q_UNREACHABLE(); } if (toType.id() == QMetaType::ULongLong) { *static_cast(to) = ull; return true; } if (toType.id() != QMetaType::QString && toType.id() != QMetaType::QByteArray) return QMetaType::convert(QMetaType::fromType(), &ull, toType, to); ll = qlonglong(ull); } else { switch (fromType.sizeOf()) { case 1: ll = *static_cast(from); break; case 2: ll = *static_cast(from); break; case 4: ll = *static_cast(from); break; case 8: ll = *static_cast(from); break; default: Q_UNREACHABLE(); } if (toType.id() == QMetaType::LongLong) { *static_cast(to) = ll; return true; } if (toType.id() != QMetaType::QString && toType.id() != QMetaType::QByteArray) return QMetaType::convert(QMetaType::fromType(), &ll, toType, to); } Q_ASSERT(toType.id() == QMetaType::QString || toType.id() == QMetaType::QByteArray); #ifndef QT_NO_QOBJECT QMetaEnum en = metaEnumFromType(fromType); if (en.isValid()) { const char *key = en.valueToKey(ll); if (toType.id() == QMetaType::QString) *static_cast(to) = QString::fromUtf8(key); else *static_cast(to) = key; return true; } #endif return false; } static bool convertToEnum(QMetaType fromType, const void *from, QMetaType toType, void *to) { int fromTypeId = fromType.id(); qlonglong value; bool ok = false; #ifndef QT_NO_QOBJECT if (fromTypeId == QMetaType::QString || fromTypeId == QMetaType::QByteArray) { QMetaEnum en = metaEnumFromType(toType); if (!en.isValid()) return false; QByteArray keys = (fromTypeId == QMetaType::QString) ? static_cast(from)->toUtf8() : *static_cast(from); value = en.keysToValue(keys.constData(), &ok); } #endif if (!ok) { if (fromTypeId == QMetaType::LongLong) { value = *static_cast(from); ok = true; } else { ok = QMetaType::convert(fromType, from, QMetaType::fromType(), &value); } } if (!ok) return false; switch (toType.sizeOf()) { case 1: *static_cast(to) = value; return true; case 2: *static_cast(to) = value; return true; case 4: *static_cast(to) = value; return true; case 8: *static_cast(to) = value; return true; default: Q_UNREACHABLE(); return false; } } #ifndef QT_BOOTSTRAPPED static bool convertIterableToVariantList(QMetaType fromType, const void *from, void *to) { QSequentialIterable list; if (!QMetaType::convert(fromType, from, QMetaType::fromType(), &list)) return false; QVariantList &l = *static_cast(to); l.clear(); l.reserve(list.size()); auto end = list.end(); for (auto it = list.begin(); it != end; ++it) l << *it; return true; } static bool convertIterableToVariantMap(QMetaType fromType, const void *from, void *to) { QAssociativeIterable map; if (!QMetaType::convert(fromType, from, QMetaType::fromType(), &map)) return false; QVariantMap &h = *static_cast(to); h.clear(); auto end = map.end(); for (auto it = map.begin(); it != end; ++it) h.insert(it.key().toString(), it.value()); return true; } static bool convertIterableToVariantHash(QMetaType fromType, const void *from, void *to) { QAssociativeIterable map; if (!QMetaType::convert(fromType, from, QMetaType::fromType(), &map)) return false; QVariantHash &h = *static_cast(to); h.clear(); h.reserve(map.size()); auto end = map.end(); for (auto it = map.begin(); it != end; ++it) h.insert(it.key().toString(), it.value()); return true; } #endif static bool convertIterableToVariantPair(QMetaType fromType, const void *from, void *to) { const QMetaType::ConverterFunction * const f = customTypesConversionRegistry()->function(qMakePair(fromType.id(), qMetaTypeId())); if (!f) return false; QtMetaTypePrivate::QPairVariantInterfaceImpl pi; (*f)(from, &pi); QVariant v1(pi._metaType_first); void *dataPtr; if (pi._metaType_first == QMetaType::fromType()) dataPtr = &v1; else dataPtr = v1.data(); pi.first(dataPtr); QVariant v2(pi._metaType_second); if (pi._metaType_second == QMetaType::fromType()) dataPtr = &v2; else dataPtr = v2.data(); pi.second(dataPtr); *static_cast(to) = QVariantPair(v1, v2); return true; } #ifndef QT_BOOTSTRAPPED static bool convertToSequentialIterable(QMetaType fromType, const void *from, void *to) { using namespace QtMetaTypePrivate; int fromTypeId = fromType.id(); QSequentialIterable &i = *static_cast(to); if (fromTypeId == QMetaType::QVariantList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } if (fromTypeId == QMetaType::QStringList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } else if (fromTypeId == QMetaType::QByteArrayList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } QSequentialIterable impl; if (QMetaType::convert( fromType, from, QMetaType::fromType>(), &impl)) { i = std::move(impl); return true; } return false; } static bool canConvertToSequentialIterable(QMetaType fromType) { switch (fromType.id()) { case QMetaType::QVariantList: case QMetaType::QStringList: case QMetaType::QByteArrayList: return true; default: return QMetaType::canConvert(fromType, QMetaType::fromType>()); } } static bool canImplicitlyViewAsSequentialIterable(QMetaType fromType) { switch (fromType.id()) { case QMetaType::QVariantList: case QMetaType::QStringList: case QMetaType::QByteArrayList: return true; default: return QMetaType::canView( fromType, QMetaType::fromType>()); } } static bool viewAsSequentialIterable(QMetaType fromType, void *from, void *to) { using namespace QtMetaTypePrivate; int fromTypeId = fromType.id(); QSequentialIterable &i = *static_cast(to); if (fromTypeId == QMetaType::QVariantList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } if (fromTypeId == QMetaType::QStringList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } else if (fromTypeId == QMetaType::QByteArrayList) { i = QSequentialIterable(reinterpret_cast(from)); return true; } QIterable j(QMetaSequence(), nullptr); if (QMetaType::view( fromType, from, QMetaType::fromType>(), &j)) { i = std::move(j); return true; } return false; } static bool convertToAssociativeIterable(QMetaType fromType, const void *from, void *to) { using namespace QtMetaTypePrivate; QAssociativeIterable &i = *static_cast(to); if (fromType.id() == QMetaType::QVariantMap) { i = QAssociativeIterable(reinterpret_cast(from)); return true; } if (fromType.id() == QMetaType::QVariantHash) { i = QAssociativeIterable(reinterpret_cast(from)); return true; } QAssociativeIterable impl; if (QMetaType::convert( fromType, from, QMetaType::fromType>(), &impl)) { i = std::move(impl); return true; } return false; } static bool canConvertMetaObject(QMetaType fromType, QMetaType toType) { const QMetaObject *f = fromType.metaObject(); const QMetaObject *t = toType.metaObject(); if (f && t) { return f->inherits(t) || (t->inherits(f)); } return false; } static bool canConvertToAssociativeIterable(QMetaType fromType) { switch (fromType.id()) { case QMetaType::QVariantMap: case QMetaType::QVariantHash: return true; default: return QMetaType::canConvert(fromType, QMetaType::fromType>()); } } static bool canImplicitlyViewAsAssociativeIterable(QMetaType fromType) { switch (fromType.id()) { case QMetaType::QVariantMap: case QMetaType::QVariantHash: return true; default: return QMetaType::canView( fromType, QMetaType::fromType>()); } } static bool viewAsAssociativeIterable(QMetaType fromType, void *from, void *to) { using namespace QtMetaTypePrivate; int fromTypeId = fromType.id(); QAssociativeIterable &i = *static_cast(to); if (fromTypeId == QMetaType::QVariantMap) { i = QAssociativeIterable(reinterpret_cast(from)); return true; } if (fromTypeId == QMetaType::QVariantHash) { i = QAssociativeIterable(reinterpret_cast(from)); return true; } QIterable j(QMetaAssociation(), nullptr); if (QMetaType::view( fromType, from, QMetaType::fromType>(), &j)) { i = std::move(j); return true; } return false; } static bool convertQObject(QMetaType fromType, const void *from, QMetaType toType, void *to) { // handle QObject conversion if ((fromType.flags() & QMetaType::PointerToQObject) && (toType.flags() & QMetaType::PointerToQObject)) { QObject *fromObject = *static_cast(from); // use dynamic metatype of from if possible if (fromObject && fromObject->metaObject()->inherits(toType.metaObject())) { *static_cast(to) = toType.metaObject()->cast(fromObject); return true; } else if (!fromObject && fromType.metaObject()) { // if fromObject is null, use static fromType to check if conversion works *static_cast(to) = nullptr; return fromType.metaObject()->inherits(toType.metaObject()); } else { return false; } } return false; } #endif /*! \fn bool QMetaType::convert(const void *from, int fromTypeId, void *to, int toTypeId) \obsolete Converts the object at \a from from \a fromTypeId to the preallocated space at \a to typed \a toTypeId. Returns \c true, if the conversion succeeded, otherwise false. \since 5.2 */ /*! Converts the object at \a from from \a fromType to the preallocated space at \a to typed \a toType. Returns \c true, if the conversion succeeded, otherwise false. \since 5.2 */ bool QMetaType::convert(QMetaType fromType, const void *from, QMetaType toType, void *to) { if (!fromType.isValid() || !toType.isValid()) return false; if (fromType == toType) { // just make a copy fromType.destruct(to); fromType.construct(to, from); return true; } int fromTypeId = fromType.id(); int toTypeId = toType.id(); if (auto moduleHelper = qModuleHelperForType(qMax(fromTypeId, toTypeId))) { if (moduleHelper->convert(from, fromTypeId, to, toTypeId)) return true; } const QMetaType::ConverterFunction * const f = customTypesConversionRegistry()->function(qMakePair(fromTypeId, toTypeId)); if (f) return (*f)(from, to); if (fromType.flags() & QMetaType::IsEnumeration) return convertFromEnum(fromType, from, toType, to); if (toType.flags() & QMetaType::IsEnumeration) return convertToEnum(fromType, from, toType, to); if (toTypeId == Nullptr) { *static_cast(to) = nullptr; if (fromType.flags() & QMetaType::IsPointer) { if (*static_cast(from) == nullptr) return true; } } if (toTypeId == QVariantPair && convertIterableToVariantPair(fromType, from, to)) return true; #ifndef QT_BOOTSTRAPPED // handle iterables if (toTypeId == QVariantList && convertIterableToVariantList(fromType, from, to)) return true; if (toTypeId == QVariantMap && convertIterableToVariantMap(fromType, from, to)) return true; if (toTypeId == QVariantHash && convertIterableToVariantHash(fromType, from, to)) return true; if (toTypeId == qMetaTypeId()) return convertToSequentialIterable(fromType, from, to); if (toTypeId == qMetaTypeId()) return convertToAssociativeIterable(fromType, from, to); return convertQObject(fromType, from, toType, to); #else return false; #endif } /*! Creates a mutable view on the object at \a from of \a fromType in the preallocated space at \a to typed \a toType. Returns \c true if the conversion succeeded, otherwise false. \since 6.0 */ bool QMetaType::view(QMetaType fromType, void *from, QMetaType toType, void *to) { if (!fromType.isValid() || !toType.isValid()) return false; int fromTypeId = fromType.id(); int toTypeId = toType.id(); const QMetaType::MutableViewFunction * const f = customTypesMutableViewRegistry()->function(qMakePair(fromTypeId, toTypeId)); if (f) return (*f)(from, to); #ifndef QT_BOOTSTRAPPED if (toTypeId == qMetaTypeId()) return viewAsSequentialIterable(fromType, from, to); if (toTypeId == qMetaTypeId()) return viewAsAssociativeIterable(fromType, from, to); return convertQObject(fromType, from, toType, to); #else return false; #endif } /*! Returns \c true if QMetaType::view can create a mutable view of type \a toType on type \a fromType. Converting between pointers of types derived from QObject will return true for this function if a qobject_cast from the type described by \a fromType to the type described by \a toType would succeed. You can create a mutable view of type QSequentialIterable on any container registered with Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(). Similarly you can create a mutable view of type QAssociativeIterable on any container registered with Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE(). \sa convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE() */ bool QMetaType::canView(QMetaType fromType, QMetaType toType) { int fromTypeId = fromType.id(); int toTypeId = toType.id(); if (fromTypeId == UnknownType || toTypeId == UnknownType) return false; const MutableViewFunction * const f = customTypesMutableViewRegistry()->function(qMakePair(fromTypeId, toTypeId)); if (f) return true; #ifndef QT_BOOTSTRAPPED if (toTypeId == qMetaTypeId()) return canImplicitlyViewAsSequentialIterable(fromType); if (toTypeId == qMetaTypeId()) return canImplicitlyViewAsAssociativeIterable(fromType); if (canConvertMetaObject(fromType, toType)) return true; #endif return false; } /*! Returns \c true if QMetaType::convert can convert from \a fromType to \a toType. The following conversions are supported by Qt: \table \header \li Type \li Automatically Cast To \row \li \l QMetaType::Bool \li \l QMetaType::QChar, \l QMetaType::Double, \l QMetaType::Int, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::UInt, \l QMetaType::ULongLong \row \li \l QMetaType::QByteArray \li \l QMetaType::Double, \l QMetaType::Int, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::UInt, \l QMetaType::ULongLong, \l QMetaType::QUuid \row \li \l QMetaType::QChar \li \l QMetaType::Bool, \l QMetaType::Int, \l QMetaType::UInt, \l QMetaType::LongLong, \l QMetaType::ULongLong \row \li \l QMetaType::QColor \li \l QMetaType::QString \row \li \l QMetaType::QDate \li \l QMetaType::QDateTime, \l QMetaType::QString \row \li \l QMetaType::QDateTime \li \l QMetaType::QDate, \l QMetaType::QString, \l QMetaType::QTime \row \li \l QMetaType::Double \li \l QMetaType::Bool, \l QMetaType::Int, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::UInt, \l QMetaType::ULongLong \row \li \l QMetaType::QFont \li \l QMetaType::QString \row \li \l QMetaType::Int \li \l QMetaType::Bool, \l QMetaType::QChar, \l QMetaType::Double, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::UInt, \l QMetaType::ULongLong \row \li \l QMetaType::QKeySequence \li \l QMetaType::Int, \l QMetaType::QString \row \li \l QMetaType::QVariantList \li \l QMetaType::QStringList (if the list's items can be converted to QStrings) \row \li \l QMetaType::LongLong \li \l QMetaType::Bool, \l QMetaType::QByteArray, \l QMetaType::QChar, \l QMetaType::Double, \l QMetaType::Int, \l QMetaType::QString, \l QMetaType::UInt, \l QMetaType::ULongLong \row \li \l QMetaType::QPoint \li QMetaType::QPointF \row \li \l QMetaType::QRect \li QMetaType::QRectF \row \li \l QMetaType::QString \li \l QMetaType::Bool, \l QMetaType::QByteArray, \l QMetaType::QChar, \l QMetaType::QColor, \l QMetaType::QDate, \l QMetaType::QDateTime, \l QMetaType::Double, \l QMetaType::QFont, \l QMetaType::Int, \l QMetaType::QKeySequence, \l QMetaType::LongLong, \l QMetaType::QStringList, \l QMetaType::QTime, \l QMetaType::UInt, \l QMetaType::ULongLong, \l QMetaType::QUuid \row \li \l QMetaType::QStringList \li \l QMetaType::QVariantList, \l QMetaType::QString (if the list contains exactly one item) \row \li \l QMetaType::QTime \li \l QMetaType::QString \row \li \l QMetaType::UInt \li \l QMetaType::Bool, \l QMetaType::QChar, \l QMetaType::Double, \l QMetaType::Int, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::ULongLong \row \li \l QMetaType::ULongLong \li \l QMetaType::Bool, \l QMetaType::QChar, \l QMetaType::Double, \l QMetaType::Int, \l QMetaType::LongLong, \l QMetaType::QString, \l QMetaType::UInt \row \li \l QMetaType::QUuid \li \l QMetaType::QByteArray, \l QMetaType::QString \endtable Casting between primitive type (int, float, bool etc.) is supported. Converting between pointers of types derived from QObject will also return true for this function if a qobject_cast from the type described by \a fromType to the type described by \a toType would succeed. A cast from a sequential container will also return true for this function if the \a toType is QVariantList. Similarly, a cast from an associative container will also return true for this function the \a toType is QVariantHash or QVariantMap. \sa convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE() */ bool QMetaType::canConvert(QMetaType fromType, QMetaType toType) { int fromTypeId = fromType.id(); int toTypeId = toType.id(); if (fromTypeId == UnknownType || toTypeId == UnknownType) return false; if (fromTypeId == toTypeId) return true; if (auto moduleHelper = qModuleHelperForType(qMax(fromTypeId, toTypeId))) { if (moduleHelper->convert(nullptr, fromTypeId, nullptr, toTypeId)) return true; } const ConverterFunction * const f = customTypesConversionRegistry()->function(qMakePair(fromTypeId, toTypeId)); if (f) return true; #ifndef QT_BOOTSTRAPPED if (toTypeId == qMetaTypeId()) return canConvertToSequentialIterable(fromType); if (toTypeId == qMetaTypeId()) return canConvertToAssociativeIterable(fromType); if (toTypeId == QVariantList && canConvert(fromType, QMetaType::fromType())) { return true; } if ((toTypeId == QVariantHash || toTypeId == QVariantMap) && canConvert(fromType, QMetaType::fromType())) { return true; } #endif if (toTypeId == QVariantPair && hasRegisteredConverterFunction( fromType, QMetaType::fromType())) return true; if (fromType.flags() & IsEnumeration) { if (toTypeId == QString || toTypeId == QByteArray) return true; return canConvert(QMetaType(LongLong), toType); } if (toType.flags() & IsEnumeration) { if (fromTypeId == QString || fromTypeId == QByteArray) return true; return canConvert(fromType, QMetaType(LongLong)); } if (toTypeId == Nullptr && fromType.flags() & IsPointer) return true; #ifndef QT_BOOTSTRAPPED if (canConvertMetaObject(fromType, toType)) return true; #endif return false; } /*! \fn bool QMetaType::compare(const void *lhs, const void *rhs, int typeId, int* result) \deprecated Use the non-static compare method instead Compares the objects at \a lhs and \a rhs. Both objects need to be of type \a typeId. \a result is set to less than, equal to or greater than zero, if \a lhs is less than, equal to or greater than \a rhs. Returns \c true, if the comparison succeeded, otherwise \c false. */ /*! \fn bool QMetaType::hasRegisteredConverterFunction() Returns \c true, if the meta type system has a registered conversion from type From to type To. \since 5.2 \overload */ /*! Returns \c true, if the meta type system has a registered conversion from meta type id \a fromType to \a toType \since 5.2 */ bool QMetaType::hasRegisteredConverterFunction(QMetaType fromType, QMetaType toType) { return customTypesConversionRegistry()->contains(qMakePair(fromType.id(), toType.id())); } /*! \fn bool QMetaType::hasRegisteredMutableViewFunction() Returns \c true, if the meta type system has a registered mutable view on type From of type To. \since 6.0 \overload */ /*! Returns \c true, if the meta type system has a registered mutable view on meta type id \a fromType of meta type id \a toType. \since 5.2 */ bool QMetaType::hasRegisteredMutableViewFunction(QMetaType fromType, QMetaType toType) { return customTypesMutableViewRegistry()->contains(qMakePair(fromType.id(), toType.id())); } /*! \fn const char *QMetaType::typeName(int typeId) \deprecated Returns the type name associated with the given \a typeId, or a null pointer if no matching type was found. The returned pointer must not be deleted. \sa type(), isRegistered(), Type, name() */ /*! \fn constexpr const char *QMetaType::name() const \since 5.15 Returns the type name associated with this QMetaType, or a null pointer if no matching type was found. The returned pointer must not be deleted. \sa typeName() */ /* Similar to QMetaType::type(), but only looks in the static set of types. */ static inline int qMetaTypeStaticType(const char *typeName, int length) { int i = 0; while (types[i].typeName && ((length != types[i].typeNameLength) || memcmp(typeName, types[i].typeName, length))) { ++i; } return types[i].type; } /* Similar to QMetaType::type(), but only looks in the custom set of types, and doesn't lock the mutex. */ static int qMetaTypeCustomType_unlocked(const char *typeName, int length) { if (auto reg = customTypeRegistry()) { #if QT_CONFIG(thread) Q_ASSERT(!reg->lock.tryLockForWrite()); #endif if (auto ti = reg->aliases.value(QByteArray(typeName, length), nullptr)) { return ti->typeId; } } return QMetaType::UnknownType; } /*! \internal Registers a user type for marshalling, as an alias of another type (typedef). Note that normalizedTypeName is not checked for conformance with Qt's normalized format, so it must already conform. */ void QMetaType::registerNormalizedTypedef(const NS(QByteArray) & normalizedTypeName, QMetaType metaType) { if (!metaType.isValid()) return; if (auto reg = customTypeRegistry()) { QWriteLocker lock(®->lock); auto &al = reg->aliases[normalizedTypeName]; if (al) return; al = metaType.d_ptr; } } /*! Returns \c true if the datatype with ID \a type is registered; otherwise returns \c false. \sa type(), typeName(), Type */ bool QMetaType::isRegistered(int type) { return QMetaType(type).isRegistered(); } template static inline int qMetaTypeTypeImpl(const char *typeName, int length) { if (!length) return QMetaType::UnknownType; int type = qMetaTypeStaticType(typeName, length); if (type == QMetaType::UnknownType) { QReadLocker locker(&customTypeRegistry()->lock); type = qMetaTypeCustomType_unlocked(typeName, length); #ifndef QT_NO_QOBJECT if ((type == QMetaType::UnknownType) && tryNormalizedType) { const NS(QByteArray) normalizedTypeName = QMetaObject::normalizedType(typeName); type = qMetaTypeStaticType(normalizedTypeName.constData(), normalizedTypeName.size()); if (type == QMetaType::UnknownType) { type = qMetaTypeCustomType_unlocked(normalizedTypeName.constData(), normalizedTypeName.size()); } } #endif } return type; } /*! \fn int QMetaType::type(const char *typeName) \deprecated Returns a handle to the type called \a typeName, or QMetaType::UnknownType if there is no such type. \sa isRegistered(), typeName(), Type */ /*! \a internal Similar to QMetaType::type(); the only difference is that this function doesn't attempt to normalize the type name (i.e., the lookup will fail for type names in non-normalized form). */ Q_CORE_EXPORT int qMetaTypeTypeInternal(const char *typeName) { return qMetaTypeTypeImpl(typeName, int(qstrlen(typeName))); } /*! \fn int QMetaType::type(const QByteArray &typeName) \since 5.5 \overload \deprecated Returns a handle to the type called \a typeName, or 0 if there is no such type. \sa isRegistered(), typeName() */ #ifndef QT_NO_DATASTREAM /*! Writes the object pointed to by \a data to the given \a stream. Returns \c true if the object is saved successfully; otherwise returns \c false. The type must have been registered with Q_DECLARE_METATYPE() beforehand. Normally, you should not need to call this function directly. Instead, use QVariant's \c operator<<(), which relies on save() to stream custom types. \sa load() */ bool QMetaType::save(QDataStream &stream, const void *data) const { if (!data || !isValid()) return false; // keep compatibility for long/ulong if (id() == QMetaType::Long) { stream << qlonglong(*(long *)data); return true; } else if (id() == QMetaType::ULong) { stream << qlonglong(*(unsigned long *)data); return true; } if (!d_ptr->dataStreamOut) return false; d_ptr->dataStreamOut(d_ptr, stream, data); return true; } /*! \fn bool QMetaType::save(QDataStream &stream, int type, const void *data) \overload \obsolete */ /*! Reads the object of this type from the given \a stream into \a data. Returns \c true if the object is loaded successfully; otherwise returns \c false. The type must have been registered with Q_DECLARE_METATYPE() beforehand. Normally, you should not need to call this function directly. Instead, use QVariant's \c operator>>(), which relies on load() to stream custom types. \sa save() */ bool QMetaType::load(QDataStream &stream, void *data) const { if (!data || !isValid()) return false; // keep compatibility for long/ulong if (id() == QMetaType::Long) { qlonglong ll; stream >> ll; *(long *)data = long(ll); return true; } else if (id() == QMetaType::ULong) { qulonglong ull; stream >> ull; *(unsigned long *)data = (unsigned long)(ull); return true; } if (!d_ptr->dataStreamIn) return false; d_ptr->dataStreamIn(d_ptr, stream, data); return true; } /*! \fn bool QMetaType::load(QDataStream &stream, int type, void *data) \overload \obsolete */ #endif // QT_NO_DATASTREAM /*! Returns a QMetaType matching \a typeName. The returned object is not valid if the typeName is not known to QMetaType */ QMetaType QMetaType::fromName(QByteArrayView typeName) { return QMetaType(qMetaTypeTypeImpl(typeName.data(), typeName.size())); } /*! \fn void *QMetaType::create(int type, const void *copy) \deprecated Returns a copy of \a copy, assuming it is of type \a type. If \a copy is zero, creates a default constructed instance. \sa destroy(), isRegistered(), Type */ /*! \fn void QMetaType::destroy(int type, void *data) \deprecated Destroys the \a data, assuming it is of the \a type given. \sa create(), isRegistered(), Type */ /*! \fn void *QMetaType::construct(int type, void *where, const void *copy) \since 5.0 \deprecated Constructs a value of the given \a type in the existing memory addressed by \a where, that is a copy of \a copy, and returns \a where. If \a copy is zero, the value is default constructed. This is a low-level function for explicitly managing the memory used to store the type. Consider calling create() if you don't need this level of control (that is, use "new" rather than "placement new"). You must ensure that \a where points to a location that can store a value of type \a type, and that \a where is suitably aligned. The type's size can be queried by calling sizeOf(). The rule of thumb for alignment is that a type is aligned to its natural boundary, which is the smallest power of 2 that is bigger than the type, unless that alignment is larger than the maximum useful alignment for the platform. For practical purposes, alignment larger than 2 * sizeof(void*) is only necessary for special hardware instructions (e.g., aligned SSE loads and stores on x86). \sa destruct(), sizeOf() */ /*! \fn void QMetaType::destruct(int type, void *where) \since 5.0 \deprecated Destructs the value of the given \a type, located at \a where. Unlike destroy(), this function only invokes the type's destructor, it doesn't invoke the delete operator. \sa construct() */ /*! \fn int QMetaType::sizeOf(int type) \since 5.0 \deprecated Returns the size of the given \a type in bytes (i.e. sizeof(T), where T is the actual type identified by the \a type argument). This function is typically used together with construct() to perform low-level management of the memory used by a type. \sa construct(), QMetaType::alignOf() */ /*! \fn QMetaType::TypeFlags QMetaType::typeFlags(int type) \since 5.0 \deprecated Returns flags of the given \a type. \sa QMetaType::TypeFlags */ /*! \fn const QMetaObject *QMetaType::metaObjectForType(int type) \since 5.0 \deprecated returns QMetaType::metaObject for \a type \sa metaObject() */ /*! \fn int qRegisterMetaType(const char *typeName) \relates QMetaType \threadsafe Registers the type name \a typeName for the type \c{T}. Returns the internal ID used by QMetaType. Any class or struct that has a public default constructor, a public copy constructor and a public destructor can be registered. This function requires that \c{T} is a fully defined type at the point where the function is called. For pointer types, it also requires that the pointed to type is fully defined. Use Q_DECLARE_OPAQUE_POINTER() to be able to register pointers to forward declared types. After a type has been registered, you can create and destroy objects of that type dynamically at run-time. This example registers the class \c{MyClass}: \snippet code/src_corelib_kernel_qmetatype.cpp 4 This function is useful to register typedefs so they can be used by QMetaProperty, or in QueuedConnections \snippet code/src_corelib_kernel_qmetatype.cpp 9 \warning This function is useful only for registering an alias (typedef) for every other use case Q_DECLARE_METATYPE and qMetaTypeId() should be used instead. \sa {QMetaType::}{isRegistered()}, Q_DECLARE_METATYPE() */ /*! \fn int qRegisterMetaType() \relates QMetaType \threadsafe \since 4.2 Call this function to register the type \c T. \c T must be declared with Q_DECLARE_METATYPE(). Returns the meta type Id. Example: \snippet code/src_corelib_kernel_qmetatype.cpp 7 This function requires that \c{T} is a fully defined type at the point where the function is called. For pointer types, it also requires that the pointed to type is fully defined. Use Q_DECLARE_OPAQUE_POINTER() to be able to register pointers to forward declared types. After a type has been registered, you can create and destroy objects of that type dynamically at run-time. To use the type \c T in QVariant, using Q_DECLARE_METATYPE() is sufficient. To use the type \c T in queued signal and slot connections, \c{qRegisterMetaType()} must be called before the first connection is established. Also, to use type \c T with the QObject::property() API, \c{qRegisterMetaType()} must be called before it is used, typically in the constructor of the class that uses \c T, or in the \c{main()} function. \sa Q_DECLARE_METATYPE() */ /*! \fn int qMetaTypeId() \relates QMetaType \threadsafe \since 4.1 Returns the meta type id of type \c T at compile time. If the type was not declared with Q_DECLARE_METATYPE(), compilation will fail. Typical usage: \snippet code/src_corelib_kernel_qmetatype.cpp 8 QMetaType::type() returns the same ID as qMetaTypeId(), but does a lookup at runtime based on the name of the type. QMetaType::type() is a bit slower, but compilation succeeds if a type is not registered. \sa Q_DECLARE_METATYPE(), QMetaType::type() */ static const QtPrivate::QMetaTypeInterface *interfaceForType(int typeId) { const QtPrivate::QMetaTypeInterface *iface = nullptr; if (typeId >= QMetaType::User) { if (auto reg = customTypeRegistry()) iface = reg->getCustomType(typeId); } else { if (auto moduleHelper = qModuleHelperForType(typeId)) iface = moduleHelper->interfaceForType(typeId); } if (!iface && typeId != QMetaType::UnknownType) qWarning("Trying to construct an instance of an invalid type, type id: %i", typeId); return iface; } /*! \fn QMetaType::QMetaType(int typeId) \since 5.0 Constructs a QMetaType object that contains all information about type \a typeId. */ QMetaType::QMetaType(int typeId) : QMetaType(interfaceForType(typeId)) {} namespace QtPrivate { #ifndef QT_BOOTSTRAPPED #if defined(Q_CC_MSVC) && defined(QT_BUILD_CORE_LIB) #define QT_METATYPE_TEMPLATE_EXPORT Q_CORE_EXPORT #else #define QT_METATYPE_TEMPLATE_EXPORT #endif // Explicit instantiation definition #define QT_METATYPE_DECLARE_TEMPLATE_ITER(TypeName, Id, Name) \ template class QT_METATYPE_TEMPLATE_EXPORT QMetaTypeForType; QT_FOR_EACH_STATIC_PRIMITIVE_TYPE(QT_METATYPE_DECLARE_TEMPLATE_ITER) QT_FOR_EACH_STATIC_PRIMITIVE_POINTER(QT_METATYPE_DECLARE_TEMPLATE_ITER) QT_FOR_EACH_STATIC_CORE_CLASS(QT_METATYPE_DECLARE_TEMPLATE_ITER) QT_FOR_EACH_STATIC_CORE_POINTER(QT_METATYPE_DECLARE_TEMPLATE_ITER) QT_FOR_EACH_STATIC_CORE_TEMPLATE(QT_METATYPE_DECLARE_TEMPLATE_ITER) #undef QT_METATYPE_DECLARE_TEMPLATE_ITER #undef QT_METATYPE_TEMPLATE_EXPORT #endif } QT_END_NAMESPACE