Obsolete Members for QMetaType

Los siguientes miembros de la clase ` QMetaType ` están obsoletos. Se mantienen para que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.

Miembros públicos estáticos

(deprecated in 6.0) bool compare(const void *lhs, const void *rhs, int typeId, int *result)
(deprecated in 6.0) void *construct(int type, void *where, const void *copy)
(deprecated in 6.0) bool convert(const void *from, int fromTypeId, void *to, int toTypeId)
(deprecated in 6.0) void *create(int type, const void *copy = nullptr)
(deprecated in 6.0) bool debugStream(QDebug &dbg, const void *rhs, int typeId)
(deprecated in 6.0) void destroy(int type, void *data)
(deprecated in 6.0) void destruct(int type, void *where)
(deprecated in 6.0) bool hasRegisteredDebugStreamOperator()
(deprecated in 6.0) bool hasRegisteredDebugStreamOperator(int typeId)
(deprecated in 6.0) bool load(QDataStream &stream, int type, void *data)
(deprecated in 6.0) const QMetaObject *metaObjectForType(int type)
(deprecated in 6.0) bool save(QDataStream &stream, int type, const void *data)
(deprecated in 6.0) int sizeOf(int type)
(deprecated in 6.0) int type(const char *typeName)
(deprecated in 6.0) int type(const QByteArray &typeName)
(deprecated in 6.0) QMetaType::TypeFlags typeFlags(int type)
(deprecated in 6.0) const char *typeName(int typeId)

Elementos no miembros relacionados

(deprecated) int qRegisterMetaType(const char *typeName)

Documentación de las funciones miembro

[static, deprecated in 6.0] bool QMetaType::compare(const void *lhs, const void *rhs, int typeId, int *result)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar el método «compare» no estático.

Compara los objetos en lhs y rhs. Ambos objetos deben ser de tipo typeId. result se establece en menor que, igual a o mayor que cero, si lhs es menor que, igual a o mayor que rhs. Devuelve true si la comparación ha tenido éxito; en caso contrario, devuelve false.

[static, deprecated in 6.0] void *QMetaType::construct(int type, void *where, const void *copy)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Crea un valor del tipo « type » especificado en la memoria existente a la que apunta « where », que es una copia de « copy », y devuelve « where ». Si « copy » es cero, el valor se crea de forma predeterminada.

Se trata de una función de bajo nivel para gestionar explícitamente la memoria utilizada para almacenar el tipo. Considera llamar a create() si no necesitas este nivel de control (es decir, utiliza «new» en lugar de «placement new»).

Debes asegurarte de que where apunte a una ubicación capaz de almacenar un valor de tipo type y de que where esté correctamente alineado. El tamaño del tipo se puede consultar llamando a sizeOf().

La regla general para la alineación es que un tipo se alinee con su límite natural, que es la potencia de 2 más pequeña que sea mayor que el tipo, a menos que esa alineación sea mayor que la alineación útil máxima para la plataforma. A efectos prácticos, una alineación mayor que 2 * sizeof(void*) solo es necesaria para instrucciones especiales de hardware (por ejemplo, cargas y almacenamientos SSE alineados en x86).

Véanse también destruct() y sizeOf().

[static, deprecated in 6.0] bool QMetaType::convert(const void *from, int fromTypeId, void *to, int toTypeId)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Convierte el objeto situado en from, de tipo fromTypeId, al espacio preasignado en to, de tipo toTypeId. Devuelve true si la conversión se ha realizado correctamente; en caso contrario, devuelve false.

Tanto from como to deben ser punteros válidos.

[static, deprecated in 6.0] void *QMetaType::create(int type, const void *copy = nullptr)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve una copia de copy, suponiendo que sea de tipo type. Si copy es cero, crea una instancia construida por defecto.

Véase también ` destroy()`, ` isRegistered()` y ` Type`.

[static, deprecated in 6.0] bool QMetaType::debugStream(QDebug &dbg, const void *rhs, int typeId)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Se trata de una función sobrecargada.

[static, deprecated in 6.0] void QMetaType::destroy(int type, void *data)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Destruye el objeto ` data`, suponiendo que sea del tipo ` type ` indicado.

Véase también create(), isRegistered() y Type.

[static, deprecated in 6.0] void QMetaType::destruct(int type, void *where)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Destruye el valor del ` type` dado, ubicado en ` where`.

A diferencia de ` destroy()`, esta función solo invoca el destructor del tipo; no invoca el operador `delete`.

Véase también ` construct()`.

[static, deprecated in 6.0] template <typename T> bool QMetaType::hasRegisteredDebugStreamOperator()

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve ` true` si el sistema de tipos meta tiene registrado un operador de flujo de depuración para el tipo `T`.

[static, deprecated in 6.0] bool QMetaType::hasRegisteredDebugStreamOperator(int typeId)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` QMetaType::hasRegisteredDebugStreamOperator()`.

Devuelve ` true`, si el sistema de tipos meta tiene registrado un operador de flujo de depuración para el identificador de tipo ` typeId`.

[static, deprecated in 6.0] bool QMetaType::load(QDataStream &stream, int type, void *data)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Se trata de una función sobrecargada.

[static, deprecated in 6.0] const QMetaObject *QMetaType::metaObjectForType(int type)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve un objeto ` QMetaType::metaObject ` para type

Véase también metaObject().

[static, deprecated in 6.0] bool QMetaType::save(QDataStream &stream, int type, const void *data)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Se trata de una función sobrecargada.

[static, deprecated in 6.0] int QMetaType::sizeOf(int type)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve el tamaño en bytes del tipo dado ` type ` (es decir, `sizeof(T)`, donde `T` es el tipo real identificado por el argumento ` type `).

Esta función se suele utilizar junto con construct() para llevar a cabo una gestión de bajo nivel de la memoria utilizada por un tipo.

Véanse también construct() y QMetaType::alignOf().

[static, deprecated in 6.0] int QMetaType::type(const char *typeName)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve un identificador del tipo denominado « typeName », o « QMetaType::UnknownType » si no existe dicho tipo.

Véase también isRegistered(), typeName() y Type.

[static, deprecated in 6.0] int QMetaType::type(const QByteArray &typeName)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve un identificador del tipo denominado « typeName », o 0 si no existe dicho tipo.

Esta es una función sobrecargada.

Véanse también isRegistered() y typeName().

[static, deprecated in 6.0] QMetaType::TypeFlags QMetaType::typeFlags(int type)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve los indicadores del objeto ` type` proporcionado.

Véase también QMetaType::TypeFlags.

[static, deprecated in 6.0] const char *QMetaType::typeName(int typeId)

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Devuelve el nombre del tipo asociado al typeId dado, o un puntero nulo si no se ha encontrado ningún tipo que coincida. El puntero devuelto no debe eliminarse.

Véase también type(), isRegistered(), Type y name().

Elementos no miembros relacionados

[deprecated] template <typename T> int qRegisterMetaType(const char *typeName)

Esta función está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Registra el nombre de tipo typeName para el tipo T. Devuelve el identificador interno utilizado por QMetaType. Se puede registrar cualquier clase o estructura que tenga un constructor por defecto público, un constructor de copia público y un destructor público.

Esta función requiere que T sea un tipo completamente definido en el momento en que se llama a la función. En el caso de los tipos de puntero, también requiere que el tipo al que apunta esté completamente definido. Utiliza Q_DECLARE_OPAQUE_POINTER() para poder registrar punteros a tipos declarados por adelantado.

Una vez registrado un tipo, puedes crear y destruir objetos de ese tipo de forma dinámica en tiempo de ejecución.

Este ejemplo registra la clase MyClass:

qRegisterMetaType<MyClass>("MyClass");

Esta función resulta útil para registrar definiciones de tipo (typedefs) de modo que puedan ser utilizadas por ` QMetaProperty` o en `QueuedConnections`.

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

Advertencia: Esta función solo es útil para registrar un alias (typedef); para cualquier otro caso de uso, se deben utilizar en su lugar Q_DECLARE_METATYPE y qMetaTypeId().

Véase también isRegistered() y Q_DECLARE_METATYPE().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.