【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());

您甚至可以将QListQMap类型的值存储在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类型的说明

由于QVariantQt Core模块的一部分,因此它无法向Qt GUI中定义的数据类型(如QColorQImageQPixmap)提供转换函数。换句话说,没有toColor()函数。相反,您可以使用QVariant::value()qvariant_cast()模板函数。例如:

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

所有由QVariant支持的数据类型,包括与GUI相关的类型,都支持反向转换(例如,从QColorQVariant),这是自动的。

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 &val) 构造一个具有列表值val的新变量。
  35. QVariant:: QVariant(const QMap &val) 构造一个具有QVariant映射val的新变量。
  36. QVariant:: QVariant(const QHash &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 ®Exp) 构造一个新的正则表达式值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()等方法时,会自动进行此类转换。
    以下转换会自动完成:
    【Qt之QVariant】使用_第1张图片

如果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;
      }
  }

结果:
【Qt之QVariant】使用_第2张图片
这需要容器的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();
      }
  }

结果:
【Qt之QVariant】使用_第3张图片

你可能感兴趣的:(Qt记录,qt,数据库,开发语言)