【Qt之QVariant】使用

介绍

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对于成功的转换来说是很重要的。

成员函数

1. QVariant:: QVariant() 构造一个无效的变量。
2. QVariant:: QVariant(Type type) 构造一个空的类型为type的变量。
3. QVariant:: QVariant(const QRegularExpression &re) 构造一个新的变量，带有正则表达式值re。该函数在Qt 5.0中引入。
4. QVariant:: QVariant(const QUrl &val) 构造一个新的变量，值为val的url。
5. QVariant:: QVariant(const QEasingCurve &val) 构造一个新的带有easing curve值val的变量。该函数在Qt 4.7中引入。
6. QVariant:: QVariant(const QUuid &val) 构造一个值为uuid值val的新变量。该函数在Qt 5.0中引入。
7. QVariant:: QVariant(const QModelIndex &val) 构造一个新的带有QModelIndex值val的变量。该函数在Qt 5.0中引入。
8. QVariant:: QVariant(const QPersistentModelIndex &val) 构造一个新的带有QPersistentModelIndex值val的变量。该函数在Qt 5.5中引入。
9. QVariant:: QVariant(const QJsonValue &val) 构造一个新的带有json值val的变量。该函数在Qt 5.0中引入。
10. QVariant:: QVariant(const QJsonObject &val) 构造一个新的带有json对象值val的变量。该函数在Qt 5.0中引入。
11. QVariant:: QVariant(const QJsonArray &val) 构造一个新的带有json数组值val的变量。该函数在Qt 5.0中引入。
12. QVariant:: QVariant(const QJsonDocument &val) 构造一个新的带有json文档值val的变量。该函数在Qt 5.0中引入。
13. QVariant:: QVariant(QVariant &&other) 移动构造一个QVariant实例，使其指向other指向的同一对象。该函数在Qt 5.2中引入。
14. QVariant:: QVariant(int typeId, const void *copy) 构造类型为typeId的变量，并且如果copy不为0则初始化为copy。注意，您必须传递要存储的变量的地址。通常情况下，您不需要使用此构造函数，而是使用. QVariant:: fromValue() 来从由QMetaType::VoidStar和QMetaType::QObjectStar表示的指针类型构造变量。另请参见. QVariant:: fromValue() 和QMetaType::Type。
15. QVariant:: QVariant(const QVariant &p) 构造一个变量的副本，该变量作为此构造函数的参数传递。
16. QVariant:: QVariant(QDataStream &s) 从数据流s中读取变量。
17. QVariant:: QVariant(int val) 构造一个带有整数值val的新变量。
18. QVariant:: QVariant(uint val) 构造一个带有无符号整数值val的新变量。
19. QVariant:: QVariant(qlonglong val) 构造一个带有长整型值val的新变量。
20. QVariant:: QVariant(qulonglong val) 构造一个带有无符号长整型值val的新变量。
21. QVariant:: QVariant(bool val) 构造一个带有布尔值val的新变量。
22. QVariant:: QVariant(double val) 构造一个带有浮点值val的新变量。
23. QVariant:: QVariant(float val) 构造一个带有浮点值val的新变量。该函数在Qt 4.6中引入。
24. QVariant:: QVariant(const char *val) 构造一个带有val字符串值的新变量。该变量会将val创建为一个QString的深拷贝，并假定输入val的编码为UTF-8。请注意，val被转换为QString以便存储在变量中，. QVariant:: userType() 将为该变量返回QMetaType::QString。可以通过在编译应用程序时定义QT_NO_CAST_FROM_ASCII来禁用该操作符。
25. QVariant:: QVariant(const QByteArray &val) 构造具有bytearray值val的新变量。
26. QVariant:: QVariant(const QBitArray &val) 构造具有bitarray值val的新变量。
27. QVariant:: QVariant(const QString &val) 构造一个具有字符串值val的新变量。
28. QVariant:: QVariant(QLatin1String val) 构造一个具有字符串值val的新变量。
29. QVariant:: QVariant(const QStringList &val) 构造一个具有字符串列表值val的新变量。
30. QVariant:: QVariant(QChar c) 构造一个具有char值c的新变量。
31. QVariant:: QVariant(const QDate &val) 构造一个具有日期值val的新变量。
32. QVariant:: QVariant(const QTime &val) 构造一个具有时间值val的新变量。
33. QVariant:: QVariant(const QDateTime &val) 构造一个具有日期/时间值val的新变量。
34. QVariant:: QVariant(const QList<QVariant> &val) 构造一个具有列表值val的新变量。
35. QVariant:: QVariant(const QMap<QString, QVariant> &val) 构造一个具有QVariant映射val的新变量。
36. QVariant:: QVariant(const QHash<QString, QVariant> &val) 构造一个具有QVariant哈希val的新变量。
37. QVariant:: QVariant(const QSize &val) 构造一个具有值为val的大小值的新变量。
38. QVariant:: QVariant(const QSizeF &val) 构造一个具有值为val的大小值的新变量。
39. QVariant:: QVariant(const QPoint &val) 构造一个具有代表点值val的新变量。
40. QVariant:: QVariant(const QPointF &val) 构造一个具有代表点值val的新变量。
41. QVariant:: QVariant(const QLine &val) 构造一个具有表示线值val的新变量。
42. QVariant:: QVariant(const QLineF &val) 构造一个具有表示线值val的新变量。
43. QVariant:: QVariant(const QRect &val) 构造一个具有表示矩形值val的新变量。
44. QVariant:: QVariant(const QRectF &val) 构造一个具有表示矩形值val的新变量。
45. QVariant:: QVariant(const QLocale &l) 构造一个具有本地值l的新变量。
46. QVariant:: QVariant(const QRegExp &regExp) 构造一个新的正则表达式值regExp的变量。
47. QVariant:: ~QVariant() 销毁QVariant和所包含的对象。
    请注意，重新实现清除的子类应重新实现析构函数以调用clear() 。这个析构函数调用clear() ，但因为它是析构函数，所以调用的是QVariant:: clear() ，而不是子类的clear() 。
48. 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 value
          qDebug() << it.key();
          qDebug() << it.value();
      }
  }

结果：