QVariant和QMetaType

原文：
http://doc.qt.io/qt-5/qvariant.html#details

http://doc.qt.io/qt-5/qmetatype.html#details

QVariant

QVariant类类似于一个包含了绝大多数普通Qt数据类型的union. 
因为C++禁止union中含有那些有非默认构造函数或析构函数的类型，大多数Qt的类就不能被包含在union中了。即使没有QVariant，这对于QObject::property()和数据库相关工作也是一个问题。

一个QVariant对象一次只能含有一个类型的一个值（有些类型是多值的，比如一个string list）。 你可以找出这个变量所包含的类型T究竟是什么，并可以使用convert()将其转换成一个不同的类型，也可以使用toT()函数来得到它的值，也可以使用canConvert()来检查这个类型是否能被转换成一个特定类型。

被命名为toT()的函数（比如，toInt(),toString()）是const的。如果需要被存储在其内的类型，toT()就会返回一个所存储对象的拷贝。如果需要的是能被所存储类型产生的类型，toT()就会copy并转换，而保持原对象不变。如果需要的是一个不能从所存储类型转换成的类型，那结果就视情况而定了，参见相关函数文档。

以下是使用QVariant的示例代码：

QDataStream out(...);
QVariant v(123);                // The variant now contains an int
int x = v.toInt();              // x = 123
out << v;                       // Writes a type tag and an int to out
v = QVariant("hello");          // The variant now contains a QByteArray
v = QVariant(tr("hello"));      // The variant now contains a QString
int y = v.toInt();              // y = 0 since v cannot be converted to an int
QString s = v.toString();       // s = tr("hello")  (see QObject::tr())
out << v;                       // Writes a type tag and a QString to out
...
QDataStream in(...);            // (opening the previously written stream)
in >> v;                        // Reads an Int variant
int z = v.toInt();              // z = 123
qDebug("Type is %s",            // prints "Type is int"
        v.typeName());
v = v.toInt() + 100;            // The variant now hold the value 223
v = QVariant(QStringList());

你甚至可以存储QList<QVariant>和QMap<QString,QVariant>的值在一个变量中，因此其实可以轻松地构建任意类型的复杂的数据结构。这是非常强大而有用的，但是可能在内存和速度上相比于标准数据结构要差一些。

QVariant也支持null值的概念，这样就可以定义有空值的类型。但是，注意，QVariant类型只在它们有值的时候才能被转型（cast）。见下面的示例代码：

QVariant x, y(QString()), z(QString(""));
x.convert(QVariant::Int);
// x.isNull() == true
// y.isNull() == true, z.isNull() == false

QVariant可以被扩展来支持没有被定义在 Type枚举中的类型。细节请参见QMetaType（译注：即下一节）。. 

关于相继使用canConvert()和convert()

当相继使用canConvert()和convert()的时候，可能canConvert()返回true，而convert()返回false. 这是因为canConvert()只报告QVariant在合适的数据的情况下类型间转换的能力。因此仍然有可能有一些数据会导致转换失败。比如，对一个含有string的变量调用canConvert(Int)会返回true，这是因为在原则上QVariant能够将string形式的数字转换成integers. 但是，如果这个string包含有非数字字样的字符，那就无法转成integer，从而会导致转换失败。因此，2个函数都返回true才能保证一个成功的转换。

QMetaType

QMetaType类管理在meta-object系统里命名的类型。
这个类是用于整理(marshall)在QVariant里和在queued signals and slots connections里的类型。它将一个类型名称关联到一个类型，以便能在运行时（run-time）动态创建和析构。
用 Q_DECLARE_METATYPE() 来声明新的类型以使得这些新类型能被QVariant和其他基于模板的函数所用（make them available to QVariant and other template-based functions）。调用 qRegisterMetaType() 可以使这些新类型被非模板函数所用(make types available to non-template based functions)，比如 the queued signal and slot connections. 

任何类或结构体(struct)，只要它有一个public的默认构造函数，一个public的拷贝构造函数，和一个public的析构函数，就可以被注册。

以下代码分配和析构一个MyClass的实例：

int id = QMetaType::type("MyClass");
if (id != QMetaType::UnknownType) {
    void *myClassPtr = QMetaType::create(id);
    ...
    QMetaType::destroy(id, myClassPtr);
    myClassPtr = 0;
}

如果希望流操作符 operator<<() 和 operator>>() 能作用于存储了自定义类型的QVariant对象上，那么自定义类型必须实现operator<<()和operator>>()操作符。