<QTypeInfo>

Macros para especificar información sobre tipos personalizados. Más...

Header: #include <QTypeInfo>

Macros

Q_DECLARE_TYPEINFO(Type, Flags)

Descripción detallada

Documentación de macros

Q_DECLARE_TYPEINFO(Type, Flags)

Puedes utilizar esta macro para especificar información sobre un tipo personalizado Type. Con información precisa sobre el tipo, los contenedores genéricos de Qt pueden elegir los métodos y algoritmos de almacenamiento adecuados.

Flags Puede ser una de las siguientes opciones:

  • Q_PRIMITIVE_TYPE especifica que Type no requiere que se realice ninguna operación para ser destruido correctamente, y que es posible utilizar memcpy() para crear una copia independiente válida de un objeto.
  • Q_RELOCATABLE_TYPE especifica que ` Type ` tiene un constructor y/o un destructor, pero que aún así puede reubicarse en memoria utilizando ` memcpy()`.
  • Q_MOVABLE_TYPE Es lo mismo que ` Q_RELOCATABLE_TYPE`. Se recomienda utilizar ` Q_RELOCATABLE_TYPE ` en el código nuevo. Nota: a pesar del nombre, esto no tiene nada que ver con los constructores de movimiento ni con la semántica de movimiento de C++.
  • Q_COMPLEX_TYPE (el valor por defecto) especifica que Type tiene constructores y/o un destructor y que no puede ser desplazado en la memoria.

Ejemplo de un tipo «primitivo»:

struct Point3D
{
    int x;
    int y;
    int z;
};

Q_DECLARE_TYPEINFO(Point3D, Q_PRIMITIVE_TYPE);

Un ejemplo de tipo «primitivo» que no es POD es QUuid: aunque QUuid tiene constructores (y, por lo tanto, no es POD), cada patrón de bits sigue representando un objeto válido, y se puede utilizar memcpy() para crear una copia válida e independiente de un objeto QUuid.

Ejemplo de un tipo reubicable:

class Point2D
{
public:
    Point2D() { data = new int[2]; }
    Point2D(const Point2D &other) { /*...*/ }
    ~Point2D() { delete[] data; }

    Point2D &operator=(const Point2D &other) { /*...*/ }

    int x() const { return data[0]; }
    int y() const { return data[1]; }

private:
    int *data;
};

Q_DECLARE_TYPEINFO(Point2D, Q_RELOCATABLE_TYPE);

Qt intentará detectar la clase de un tipo utilizando los rasgos de tipo estándar de C++; utiliza esta macro para ajustar el comportamiento. Por ejemplo, muchos tipos serían candidatos a Q_RELOCATABLE_TYPE a pesar de no ser trivialmente copiables.

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