QMetaType Class

See also https://(), https://(), https://(), https://()

These are the built-in types supported by https://:

Additional types can be registered using https://().

See Also▲

flags QMetaType::TypeFlags

The enum describes attributes of a type supported by https://.

The TypeFlags type is a typedef for https://<TypeFlag>. It stores an OR combination of TypeFlag values.

Constructs a https:// object that contains all information about type typeId.

This function was introduced in Qt 5.0.

Destructs this object.

Compares the objects at lhs and rhs. Both objects need to be of type typeId. result is set to less than, equal to or greater than zero, if lhs is less than, equal to or greater than rhs. Returns true, if the comparison succeeded, otherwise false.

This function was introduced in Qt 5.2.

Constructs a value of the given type in the existing memory addressed by where, that is a copy of copy, and returns where. If 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 https://() if you don't need this level of control (that is, use "new" rather than "placement new").

You must ensure that where points to a location that can store a value of type type, and that where is suitably aligned. The type's size can be queried by calling https://().

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).

This function was introduced in Qt 5.0.

See Also▲

Constructs a value of the type that this https:// instance was constructed for in the existing memory addressed by where, that is a copy of copy, and returns where. If 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 https://() if you don't need this level of control (that is, use "new" rather than "placement new").

You must ensure that where points to a location where the new value can be stored and that where is suitably aligned. The type's size can be queried by calling https://().

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).

This function was introduced in Qt 5.0.

Converts the object at from from fromTypeId to the preallocated space at to typed toTypeId. Returns true, if the conversion succeeded, otherwise false.

This function was introduced in Qt 5.2.

Returns a copy of copy, assuming it is of type type. If copy is zero, creates a default constructed instance.

See Also▲

Returns a copy of copy, assuming it is of the type that this https:// instance was created for. If copy is null, creates a default constructed instance.

This function was introduced in Qt 5.0.

See Also▲

Streams the object at rhs of type typeId to the debug stream dbg. Returns true on success, otherwise false.

This function was introduced in Qt 5.2.

Destroys the data, assuming it is of the type given.

See Also▲

Destroys the data, assuming it is of the type that this https:// instance was created for.

This function was introduced in Qt 5.0.

See Also▲

Destructs the value of the given type, located at where.

Unlike https://(), this function only invokes the type's destructor, it doesn't invoke the delete operator.

This function was introduced in Qt 5.0.

See Also▲

Destructs the value, located at data, assuming that it is of the type for which this https:// instance was constructed for.

Unlike https://(), this function only invokes the type's destructor, it doesn't invoke the delete operator.

This function was introduced in Qt 5.0.

See Also▲

Compares the objects at lhs and rhs. Both objects need to be of type typeId. result is set to zero, if lhs equals to rhs. Returns true, if the comparison succeeded, otherwise false.

This function was introduced in Qt 5.5.

Returns flags of the type for which this https:// instance was constructed.

This function was introduced in Qt 5.0.

See Also▲

Returns true, if the meta type system has registered comparators for type T.

This function was introduced in Qt 5.2.

Returns true, if the meta type system has registered comparators for type id typeId.

This function was introduced in Qt 5.2.

Returns true, if the meta type system has a registered conversion from meta type id fromTypeId to toTypeId

This function was introduced in Qt 5.2.

Returns true, if the meta type system has a registered conversion from type From to type To.

This is an overloaded function.

This function was introduced in Qt 5.2.

Returns true, if the meta type system has a registered debug stream operator for type T.

This function was introduced in Qt 5.2.

Returns true, if the meta type system has a registered debug stream operator for type id typeId.

This function was introduced in Qt 5.2.

Returns true if the datatype with ID type is registered; otherwise returns false.

See Also▲

Returns true if this https:// object contains valid information about a type, false otherwise.

This function was introduced in Qt 5.0.

Returns true if this https:// object contains valid information about a type, false otherwise.

This function was introduced in Qt 5.0.

Reads the object of the specified type from the given stream into data. Returns true if the object is loaded successfully; otherwise returns false.

The type must have been registered with https://() and https://() beforehand.

Normally, you should not need to call this function directly. Instead, use https://'s operator>>(), which relies on load() to stream custom types.

See Also▲

return a https:// relative to this type.

If the type is a pointer type to a subclass of https://, https://() contains https:// and this function returns the corresponding https://. This can be used to in combinaison with QMetaObject::construct to create https:// of this type.

If the type is a https://, https://() contains https://, and this function returns its https://. This can be used to retrieve https:// and https:// and use them on a pointer of this type. (given by QVariant::data for example)

If the type is an enumeration, https://() contains https://, and this function returns the https:// of the enclosing object if the enum was registered as a https:// or 0 otherwise

This function was introduced in Qt 5.5.

See Also▲

returns https:// for type

This function was introduced in Qt 5.0.

See Also▲

Registers comparison operators for the user-registered type T. This requires T to have both an operator== and an operator<. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.2.

Registers the possibility of an implicit conversion from type From to type To in the meta type system. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.2.

This is an overloaded function.

Registers a method function like To From::function() const as converter from type From to type To in the meta type system. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.2.

This is an overloaded function.

Registers a method function like To From::function(bool *ok) const as converter from type From to type To in the meta type system. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.2.

This is an overloaded function.

Registers a unary function object function as converter from type From to type To in the meta type system. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.2.

Registers the debug stream operator for the user-registered type T. This requires T to have an operator<<(https:// dbg, T). Returns true if the registration succeeded, otherwise false.

Registers equals operator for the user-registered type T. This requires T to have an operator==. Returns true if the registration succeeded, otherwise false.

This function was introduced in Qt 5.5.

Writes the object pointed to by data with the ID type to the given stream. Returns true if the object is saved successfully; otherwise returns false.

The type must have been registered with https://() and https://() beforehand.

Normally, you should not need to call this function directly. Instead, use https://'s operator<<(), which relies on save() to stream custom types.

See Also▲

Returns the size of the given type in bytes (i.e. sizeof(T), where T is the actual type identified by the type argument).

This function is typically used together with https://() to perform low-level management of the memory used by a type.

This function was introduced in Qt 5.0.

See Also▲

Returns the size of the type in bytes (i.e. sizeof(T), where T is the actual type for which this https:// instance was constructed for).

This function is typically used together with https://() to perform low-level management of the memory used by a type.

This function was introduced in Qt 5.0.

See Also▲

Returns a handle to the type called typeName, or https:// if there is no such type.

See Also▲

This is an overloaded function.

Returns a handle to the type called typeName, or 0 if there is no such type.

This function was introduced in Qt 5.5.

See Also▲

Returns flags of the given type.

This function was introduced in Qt 5.0.

See Also▲

Returns the type name associated with the given typeId, or a null pointer if no matching type was found. The returned pointer must not be deleted.

See Also▲

Returns the meta type id of type T at compile time. If the type was not declared with https://(), compilation will fail.

Typical usage:

int id = qMetaTypeId<QString>();    // id is now QMetaType::QString
id = qMetaTypeId<MyStruct>();       // compile error if MyStruct not declared

https://() returns the same ID as qMetaTypeId(), but does a lookup at runtime based on the name of the type. https://() is a bit slower, but compilation succeeds if a type is not registered.

This function was introduced in Qt 4.1.

See Also▲

Registers the type name typeName for the type T. Returns the internal ID used by https://. 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 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 https://() 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 MyClass:

qRegisterMetaType<MyClass>("MyClass");

This function is useful to register typedefs so they can be used by https://, or in QueuedConnections

typedef QString CustomString;
qRegisterMetaType<CustomString>("CustomString");

See Also▲

Call this function to register the type T. T must be declared with https://(). Returns the meta type Id.

Example:

int id = qRegisterMetaType<MyStruct>();

This function requires that 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 https://() 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 T in https://, using https://() is sufficient. To use the type T in queued signal and slot connections, qRegisterMetaType<T>() must be called before the first connection is established.

Also, to use type T with the https://() API, qRegisterMetaType<T>() must be called before it is used, typically in the constructor of the class that uses T, or in the main() function.

This function was introduced in Qt 4.2.

See Also▲

Registers the stream operators for the type T called typeName.

Afterward, the type can be streamed using https://() and https://(). These functions are used when streaming a https://.

qRegisterMetaTypeStreamOperators<MyClass>("MyClass");

The stream operators should have the following signatures:

QDataStream &operator<<(QDataStream &out, const MyClass &myObj);
QDataStream &operator>>(QDataStream &in, MyClass &myObj);

See Also▲

This macro makes the container Container known to https:// as an associative container. This makes it possible to put an instance of Container<T, U> into a https://, if T and U are themselves known to https://.

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():

#include <unordered_list>

Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE(std::unordered_map)

void someFunc()
{
    std::unordered_map<int, bool> container;
    QVariant var = QVariant::fromValue(container);
    // ...
}

This macro makes the type Type known to https:// as long as it provides a public default constructor, a public copy constructor and a public destructor. It is needed to use the type Type as a custom type in https://.

This macro requires that 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 https://() 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 https://.

Adding a Q_DECLARE_METATYPE() makes the type known to all template based functions, including https://. Note that if you intend to use the type in queued signal and slot connections or in https://'s property system, you also have to call https://() since the names are resolved at runtime.

This example shows a typical use case of Q_DECLARE_METATYPE():

struct MyStruct
{
    int i;
    ...
};

Q_DECLARE_METATYPE(MyStruct)

If MyStruct is in a namespace, the Q_DECLARE_METATYPE() macro has to be outside the namespace:

namespace MyNamespace
{
    ...
}

Q_DECLARE_METATYPE(MyNamespace::MyStruct)

Since MyStruct is now known to https://, it can be used in https://:

MyStruct s;
QVariant var;
var.setValue(s); // copy s into the variant

...

// retrieve the value
MyStruct s2 = var.value<MyStruct>();

Some types are registered automatically and do not need this macro:

• Pointers to classes derived from https://

• https://<T>, https://<T>, https://<T>, https://<T>, https://<T> or https://<T> where T is a registered meta type

• https://<T1, T2>, https://<T1, T2> or https://<T1, T2> where T1 and T2 are registered meta types

• https://<T>, https://<T>, https://<T>, where T is a class that derives from https://

• Enumerations registered with https:// or https://

• Classes that have a https:// macro

See Also▲

This macro enables pointers to forward-declared types (PointerType) to be registered with https:// using either https://() or https://().

This macro was introduced in Qt 5.0.

See Also▲

This macro makes the container Container known to https:// as a sequential container. This makes it possible to put an instance of Container<T> into a https://, if T itself is known to https://.

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():

#include <deque>

Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(std::deque)

void someFunc()
{
    std::deque<QFile*> container;
    QVariant var = QVariant::fromValue(container);
    // ...
}

This macro makes the smart pointer SmartPointer known to https:// as a smart pointer. This makes it possible to put an instance of SmartPointer<T> into a https://, if T is a type which inherits https://.

Note that the https://, https:// and https:// 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():

#include <memory>

Q_DECLARE_SMART_POINTER_METATYPE(std::shared_ptr)

void someFunc()
{
    auto smart_ptr = std::make_shared<QFile>();
    QVariant var = QVariant::fromValue(smart_ptr);
    // ...
    if (var.canConvert<QObject*>()) {
        QObject *sp = var.value<QObject*>();
        qDebug() << sp->metaObject()->className(); // Prints 'QFile'.
    }
}