Qt 实战（3）数据类型 | 3.2、QVariant

前言：

QVariant是Qt框架中一个非常强大且灵活的类，它提供了一种通用的方式来存储和转换几乎任何类型的数据。无论是基本数据类型（如int、float、bool）还是复杂的Qt类型（如QString、QDate、QPixmap等），甚至是用户自定义类型，QVariant都能轻松应对。下面将详细介绍QVariant的用法。

一、QVariant

1、存储数据

1.1、存储Qt内置数据

QVariant通过其构造函数或setValue()方法可以存储不同类型的内置数据。例如：

QVariant var1 = 10; // 存储整数  
QVariant var2 = "Hello, QVariant"; // 存储字符串  
QVariant var3 = QDateTime::currentDateTime(); // 存储当前日期和时间

1.2、存储自定义数据

如果要存储自定义类型，需要先使用Q_DECLARE_METATYPE宏声明，然后通过setValue()方法存储，例如：

struct MyData {  
    int valueA = 100;  
    QString str = "HelloWorld";  
};  
Q_DECLARE_METATYPE(MyData)  
  
QVariant var4;  
MyData myData;  
var4.setValue(myData); // 存储自定义类型

注意：QVariant通过构造函数不能直接存储自定义类型。对于自定义类型，需要先使用Q_DECLARE_METATYPE宏进行声明，然后可以使用setValue()方法将自定义类型的数据存储到QVariant对象中。

2、获取数据

QVariant提供了多种转换函数（如toInt()、toDouble()、toString()等），可以将存储的数据转换为指定类型。例如：

int intValue = var1.toInt(); // 将QVariant转换为int类型  
QString strValue = var2.toString(); // 将QVariant转换为QString类型  
QDateTime dateTime = var3.toDateTime(); // 将QVariant转换为QDateTime类型

对于自定义类型，可以使用value<T>()方法进行转换，前提是QVariant对象包含的数据类型可以转换为T类型，如下：

MyData tempData = var4.value<MyData>(); // 将QVariant转换为MyData类型

QVariant提供的存储与获取自定义数据的方法，如下：

// 存储
template<typename T>
inline void QVariant::setValue(const T &value);

// 获取
template<typename T>
inline T QVariant::value() const
{ return qvariant_cast<T>(*this); }

3、判断数据类型

QVariant提供了type()函数，可以获取存储的数据的类型。同时，canConvert<T>()函数可以用来判断QVariant对象是否可以转换为T类型，方法声明如下：

// 获取存储数据的类型
Type QVariant::type() const;
bool QVariant::canConvert(int targetTypeId) const;

// 判断是否能转换成指定类型
template<typename T>
bool QVariant::canConvert() const
{ return canConvert(qMetaTypeId<T>()); }

示例：

if (var1.type() == QVariant::Int) {  
    qDebug() << "var1 is an integer";  
}  
  
if (var2.canConvert<QString>()) {  
    qDebug() << "var2 can be converted to QString";  
}

4、清空数据

可以使用clear()函数清空QVariant对象中存储的数据。

var1.clear(); // 清空var1中存储的数据

5、总结

QVariant是Qt中一个功能强大的类，它提供了一种通用的方式来存储和转换不同类型的数据。通过QVariant，Qt开发者可以更加灵活地处理数据，特别是在需要动态处理多种数据类型的场合。掌握QVariant的用法，对于提升Qt应用程序的开发效率和灵活性具有重要意义。