当前位置：首页 > news >正文

【Qt之QVariant】使用

news 2026/3/31 22:39:41

介绍

QVariant类类似于最常见的Qt数据类型的联合。由于C++禁止联合类型包括具有非默认构造函数或析构函数的类型，大多数有趣的Qt类不能在联合中使用。如果没有QVariant，则QObject::property()和数据库操作等将会受到影响。

QVariant对象同时持有一个单一类型（T）的单一值（一些类型是多值的，例如字符串列表）。您可以通过convert()将其转换为不同的类型T，使用其中一个toT()函数（例如toSize()）获取其值，并使用canConvert()检查该类型是否可以转换为特定类型。

以toT()（例如toInt()，toString()）命名的方法是const的。如果您请求存储的类型，则它们返回存储对象的副本。如果要求使用存储的类型生成的类型，则toT()会复制和转换并保留对象本身不变。如果要求一种无法从存储的类型生成的类型，则结果取决于该类型；有关详细信息，请参见函数文档。

以下是一些示例代码，演示了QVariant的用法：

QDataStream out(...);
QVariant v(123); // variant现在包含一个int
int x = v.toInt(); // x=123
out << v; // 在out中写入类型标记和一个int
v = QVariant("hello");// variant现在包含一个QByteArray
v = QVariant(tr("hello")); // variant现在包含一个QString
int y = v.toInt(); // y=0，因为v不能转换为int
QString s = v.toString(); // s=tr("hello")  （参见QObject::tr（））
out << v; // 在out中写入类型标记和一个QString
...
QDataStream in(...); //（打开先前编写的流）
in >> v; //读取int变量
int z = v.toInt(); // z=123
qDebug("Type is %s",v.typeName()); // 打印“Type is int”
v = v.toInt()+100; // variant现在拥有值223
v = QVariant(QStringList());

您甚至可以将QList<QVariant>和QMap<QString，QVariant>类型的值存储在variant中，因此您可以轻松构建任意类型的任意复杂度的数据结构。这非常强大和灵活，但可能比在标准数据结构中存储特定类型的方式低效。

QVariant还支持空值的概念，在该概念下，您可以拥有未设置值的定义类型。但是，请注意，只有在设置了值时，QVariant类型才能进行强制转换。

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

QVariant可以扩展以支持Type枚举中未提到的其他类型。

关于GUI类型的说明

由于QVariant是Qt Core模块的一部分，因此它无法向Qt GUI中定义的数据类型（如QColor、QImage和QPixmap）提供转换函数。换句话说，没有toColor()函数。相反，您可以使用QVariant::value()或qvariant_cast()模板函数。例如：

QVariant variant;
...
QColor color = variant.value<QColor>();

所有由QVariant支持的数据类型，包括与GUI相关的类型，都支持反向转换（例如，从QColor到QVariant），这是自动的。

QColor color = palette().background().color();
QVariant variant = color;

连续使用`canConvert()`和`convert()`

当连续使用canConvert()和convert()时，canConvert()可能会返回true，但convert()会返回false。这通常是因为canConvert()仅报告了QVariant在给定适当数据的情况下转换类型的一般能力；仍然可能提供实际上无法转换的数据。

例如，当在包含字符串的variant上调用canConvert(Int)时，它将返回true，因为原则上，QVariant能够将数字字符串转换为整数。然而，如果字符串包含非数字字符，则无法将其转换为整数，任何尝试将其转换将失败。因此，两个函数都返回true对于成功的转换来说是很重要的。

成员函数

QVariant:: QVariant() 构造一个无效的变量。
QVariant:: QVariant(Type type) 构造一个空的类型为type的变量。
QVariant:: QVariant(const QRegularExpression &re) 构造一个新的变量，带有正则表达式值re。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QUrl &val) 构造一个新的变量，值为val的url。
QVariant:: QVariant(const QEasingCurve &val) 构造一个新的带有easing curve值val的变量。该函数在Qt 4.7中引入。
QVariant:: QVariant(const QUuid &val) 构造一个值为uuid值val的新变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QModelIndex &val) 构造一个新的带有QModelIndex值val的变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QPersistentModelIndex &val) 构造一个新的带有QPersistentModelIndex值val的变量。该函数在Qt 5.5中引入。
QVariant:: QVariant(const QJsonValue &val) 构造一个新的带有json值val的变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QJsonObject &val) 构造一个新的带有json对象值val的变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QJsonArray &val) 构造一个新的带有json数组值val的变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(const QJsonDocument &val) 构造一个新的带有json文档值val的变量。该函数在Qt 5.0中引入。
QVariant:: QVariant(QVariant &&other) 移动构造一个QVariant实例，使其指向other指向的同一对象。该函数在Qt 5.2中引入。
QVariant:: QVariant(int typeId, const void *copy) 构造类型为typeId的变量，并且如果copy不为0则初始化为copy。注意，您必须传递要存储的变量的地址。通常情况下，您不需要使用此构造函数，而是使用. QVariant:: fromValue() 来从由QMetaType::VoidStar和QMetaType::QObjectStar表示的指针类型构造变量。另请参见. QVariant:: fromValue() 和QMetaType::Type。
QVariant:: QVariant(const QVariant &p) 构造一个变量的副本，该变量作为此构造函数的参数传递。
QVariant:: QVariant(QDataStream &s) 从数据流s中读取变量。
QVariant:: QVariant(int val) 构造一个带有整数值val的新变量。
QVariant:: QVariant(uint val) 构造一个带有无符号整数值val的新变量。
QVariant:: QVariant(qlonglong val) 构造一个带有长整型值val的新变量。
QVariant:: QVariant(qulonglong val) 构造一个带有无符号长整型值val的新变量。
QVariant:: QVariant(bool val) 构造一个带有布尔值val的新变量。
QVariant:: QVariant(double val) 构造一个带有浮点值val的新变量。
QVariant:: QVariant(float val) 构造一个带有浮点值val的新变量。该函数在Qt 4.6中引入。
QVariant:: QVariant(const char *val) 构造一个带有val字符串值的新变量。该变量会将val创建为一个QString的深拷贝，并假定输入val的编码为UTF-8。请注意，val被转换为QString以便存储在变量中，. QVariant:: userType() 将为该变量返回QMetaType::QString。可以通过在编译应用程序时定义QT_NO_CAST_FROM_ASCII来禁用该操作符。
QVariant:: QVariant(const QByteArray &val) 构造具有bytearray值val的新变量。
QVariant:: QVariant(const QBitArray &val) 构造具有bitarray值val的新变量。
QVariant:: QVariant(const QString &val) 构造一个具有字符串值val的新变量。
QVariant:: QVariant(QLatin1String val) 构造一个具有字符串值val的新变量。
QVariant:: QVariant(const QStringList &val) 构造一个具有字符串列表值val的新变量。
QVariant:: QVariant(QChar c) 构造一个具有char值c的新变量。
QVariant:: QVariant(const QDate &val) 构造一个具有日期值val的新变量。
QVariant:: QVariant(const QTime &val) 构造一个具有时间值val的新变量。
QVariant:: QVariant(const QDateTime &val) 构造一个具有日期/时间值val的新变量。
QVariant:: QVariant(const QList<QVariant> &val) 构造一个具有列表值val的新变量。
QVariant:: QVariant(const QMap<QString, QVariant> &val) 构造一个具有QVariant映射val的新变量。
QVariant:: QVariant(const QHash<QString, QVariant> &val) 构造一个具有QVariant哈希val的新变量。
QVariant:: QVariant(const QSize &val) 构造一个具有值为val的大小值的新变量。
QVariant:: QVariant(const QSizeF &val) 构造一个具有值为val的大小值的新变量。
QVariant:: QVariant(const QPoint &val) 构造一个具有代表点值val的新变量。
QVariant:: QVariant(const QPointF &val) 构造一个具有代表点值val的新变量。
QVariant:: QVariant(const QLine &val) 构造一个具有表示线值val的新变量。
QVariant:: QVariant(const QLineF &val) 构造一个具有表示线值val的新变量。
QVariant:: QVariant(const QRect &val) 构造一个具有表示矩形值val的新变量。
QVariant:: QVariant(const QRectF &val) 构造一个具有表示矩形值val的新变量。
QVariant:: QVariant(const QLocale &l) 构造一个具有本地值l的新变量。
QVariant:: QVariant(const QRegExp &regExp) 构造一个新的正则表达式值regExp的变量。
QVariant:: ~QVariant() 销毁QVariant和所包含的对象。
请注意，重新实现清除的子类应重新实现析构函数以调用clear() 。这个析构函数调用clear() ，但因为它是析构函数，所以调用的是QVariant:: clear() ，而不是子类的clear() 。
bool QVariant::canConvert(int targetTypeId) const:如果变量的类型可以转换为请求的类型targetTypeId，则返回true。在调用toInt()、toBool()等方法时，会自动进行此类转换。以下转换会自动完成：
bool QVariant::canConvert(int targetTypeId) const
如果变量的类型可以转换为请求的类型targetTypeId，则返回true。在调用toInt()、toBool()等方法时，会自动进行此类转换。
以下转换会自动完成：

如果QVariant包含指向QObject派生类型的指针，则如果可以进行与targetTypeId所描述的类型相对应的qobject_cast，则此函数也将返回true。请注意，这仅适用于使用Q_OBJECT宏的QObject子类。

如果QVariant包含一个顺序容器，则如果targetTypeId为QVariantList，则该函数也将返回true。可以在不将其提取为（复制的）QVariantList的情况下迭代容器的内容。

QList<int> intList = {7, 11, 42};QVariant variant = QVariant::fromValue(intList);if (variant.canConvert<QVariantList>()) {QSequentialIterable iterable = variant.value<QSequentialIterable>();// Can use foreach:foreach (const QVariant &v, iterable) {qDebug() << v;}// Can use C++11 range-for:for (const QVariant &v : iterable) {qDebug() << v;}// Can use iterators:QSequentialIterable::const_iterator it = iterable.begin();const QSequentialIterable::const_iterator end = iterable.end();for ( ; it != end; ++it) {qDebug() << *it;}}

结果：
在这里插入图片描述
这需要容器的value_type本身是一个元类型。类似地，如果QVariant包含一个顺序容器，则如果targetTypeId为QVariantHash或QVariantMap，则该函数也将返回true。可以在不将其提取为（复制的）QVariantHash或QVariantMap的情况下迭代容器的内容：

  QHash<int, QString> mapping;mapping.insert(7, "Seven");mapping.insert(11, "Eleven");mapping.insert(42, "Forty-two");QVariant variant = QVariant::fromValue(mapping);if (variant.canConvert<QVariantHash>()) {QAssociativeIterable iterable = variant.value<QAssociativeIterable>();// Can use foreach over the values:foreach (const QVariant &v, iterable) {qDebug() << v;}// Can use C++11 range-for over the values:for (const QVariant &v : iterable) {qDebug() << v;}// Can use iterators:QAssociativeIterable::const_iterator it = iterable.begin();const QAssociativeIterable::const_iterator end = iterable.end();for ( ; it != end; ++it) {qDebug() << *it; // The current valueqDebug() << it.key();qDebug() << it.value();}}

结果：
在这里插入图片描述

【Qt之QVariant】使用

介绍

关于GUI类型的说明

连续使用`canConvert()`和`convert()`

成员函数

相关文章：