原文:
http://doc.qt.io/qt-5/qvariant.html#details
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的示例代码:
你甚至可以存储QList<QVariant>和QMap<QString,QVariant>的值在一个变量中,因此其实可以轻松地构建任意类型的复杂的数据结构。这是非常强大而有用的,但是可能在内存和速度上相比于标准数据结构要差一些。
QVariant也支持null值的概念,这样就可以定义有空值的类型。但是,注意,QVariant类型只在它们有值的时候才能被转型(cast)。见下面的示例代码:
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类管理在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的实例:
如果希望流操作符 operator<<() 和 operator>>() 能作用于存储了自定义类型的QVariant对象上,那么自定义类型必须实现operator<<()和operator>>()操作符。
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>>()操作符。