Qt_QVariantQVariant 是 Qt 框架中一个非常实用的类它类似于 C 的 union但功能更强大可以安全地存储几乎所有常见的 Qt 数据类型和 C 基本类型。为什么需要 QVariantC 原生的 union 不允许包含有非默认构造函数或析构函数的类型因此大多数 Qt 类无法放入 union 中。QVariant 解决了这个问题广泛应用于 QObject::property()、数据库操作、信号槽传参等场景。QVariant支持的类型Variant 默认支持以下类型C 基本类型int、uint、bool、double、float、qlonglong、qulonglongQt 核心类型QString、QByteArray、QChar、QStringList、QDate、QTime、QDateTime、QUrl、QUuid几何类型QPoint、QPointF、QSize、QSizeF、QRect、QRectF、QLine、QLineF容器类型QListQVariant即 QVariantList、QMapQString, QVariant即 QVariantMap、QHashQString, QVariant即 QVariantHashJSON 类型QJsonValue、QJsonObject、QJsonArray、QJsonDocumentGUI 类型需通过valueT() 访问QColor、QFont、QPixmap、QBrush、QPen 等基本用法存储数据// 通过构造函数QVariantv1(123);QVariantv2(hello);QVariantv3(3.14);// 通过 setValue()QVariant v4;v4.setValue(42);// 通过静态方法 fromValue()QVariant v5QVariant::fromValue(100);读取数据QVariantv(123);intiv.toInt();// i 123QString sv.toString();// s 123doubledv.toDouble();// d 123.0boolbv.toBool();// b true// 模板方式通用intvalv.valueint();类型判断与转换QVariantv(42);v.typeName();// 返回 intv.userType();// 返回 QMetaType::Intv.canConvertQString();// 返回 truev.canConvertQColor();// 返回 false// 强制转换v.convert(QMetaType::QString);// 转换后存储 42自定义类型的使用对于自定义类型struct或class需要满足两个条件有默认构造函数和拷贝构造函数使用 Q_DECLARE_METATYPE() 宏注册类型// 头文件中定义并注册structStudent{intid;QString name;intage;};Q_DECLARE_METATYPE(Student)// 使用Student stu;stu.id1;stu.name张三;stu.age18;// 存储QVariant varQVariant::fromValue(stu);// 读取if(var.canConvertStudent()){Student svar.valueStudent();qDebug()s.names.age;}存储指针// 保存QVariant varQVariant::fromValue((void*)somePointer);// 获取SomeType*ptr(SomeType*)var.valuevoid*();处理不支持的基本类型对于 short、char 等 QVariant 没有专用构造函数的类型可以先转为 int 存取// char - QVariantQVariant varB;// 实际存储为 int(66)charc(char)var.toInt();// 取出后转回 char// short - QVariantshorts12;QVariant var2s;// 实际存储为 int(12)shorts2(short)var2.toInt();常用 API 速查方法说明setValue(const T )存储值fromValue(const T )静态方法创建含值的 QVarianttoT()转换为具体类型如toInt()、toString()valueT()模板方式取值适用于自定义类型canConvertT()判断能否转换为类型 Tconvert(int)强制类型转换type()/userType()获取存储类型typeName()获取类型名称字符串isNull()是否为空值isValid()是否为有效类型clear()清空为UnknownTypeend~