QVariant：Qt中万能类型的使用与理解

ops/2025/3/18 16:56:20/

目录

1.引言

2.QVariant的用法

2.1.包含头文件

2.2.基本类型的存储与获取

2.3.自定义类型的存储与获取

2.4.枚举类型的存储与获取

2.5.类型检查与转换

2.6.容器类型的存储与获取

3.枚举的问题

4.信号槽中使用自定义结构体

4.1.使用QVariant转换

4.2.直接传递自定义结构体

5.性能开销

5.1. 内存开销

5.2. 时间开销

5.3. 与直接使用具体类型的对比

6.总结

1.引言

        在Qt框架中，QVariant类是一个非常强大的工具，它允许我们存储各种类型的数据，并在需要时将其转换为原始类型。QVariant类似于C语言中的void*，但它更加类型安全，并且能够存储多种数据类型。然而，QVariant在处理枚举类型（enum）、自定义结构体时存在一些限制。本文将探讨如何解决这一问题，使QVariant能够与枚举类型、自定义结构体协同工作。

2.QVariant的用法

  QVariant 是 Qt 中一个非常强大且灵活的类，它可以存储多种不同类型的数据，并且可以在不同类型之间进行转换。

2.1.包含头文件

在使用 QVariant 之前，需要包含相应的头文件：

#include <QVariant>

这一点我是经常忘掉，导致编译错误，但是又不是很容易发现是没有包含头文件QVariant。

2.2.基本类型的存储与获取

QVariant 可以存储许多基本数据类型，如整数、浮点数、字符串等。

存储基本类型

#include <QVariant>
#include <QDebug>int main() {// 存储整数QVariant intVariant = 42;// 存储浮点数QVariant doubleVariant = 3.14;// 存储字符串QVariant stringVariant = "Hello, World!";return 0;
}

获取基本类型

#include <QVariant>
#include <QDebug>int main() {QVariant intVariant = 42;QVariant doubleVariant = 3.14;QVariant stringVariant = "Hello, World!";// 获取整数int intValue = intVariant.toInt();// 获取浮点数double doubleValue = doubleVariant.toDouble();// 获取字符串QString stringValue = stringVariant.toString();qDebug() << "Int value:" << intValue;qDebug() << "Double value:" << doubleValue;qDebug() << "String value:" << stringValue;return 0;
}

2.3.自定义类型的存储与获取

对于自定义类型，需要将其注册到 Qt 的元对象系统中，以便 QVariant 能够处理。

定义自定义类型

#include <QObject>
#include <QVariant>
#include <QDebug>// 定义自定义类型
class MyClass {
public:MyClass(int value) : m_value(value) {}int value() const { return m_value; }
private:int m_value;
};// 注册自定义类型
Q_DECLARE_METATYPE(MyClass)int main() {// 存储自定义类型MyClass myObject(123);QVariant customVariant = QVariant::fromValue(myObject);// 获取自定义类型if (customVariant.canConvert<MyClass>()) {MyClass retrievedObject = customVariant.value<MyClass>();qDebug() << "Retrieved value:" << retrievedObject.value();}return 0;
}

2.4.枚举类型的存储与获取

对于枚举类型，需要使用 Q_ENUM 宏将其注册到元对象系统中。

#include <QObject>
#include <QVariant>
#include <QDebug>// 定义枚举类型
class MyEnumClass : public QObject {Q_OBJECT
public:enum MyEnum {Option1,Option2,Option3};Q_ENUM(MyEnum)
};int main() {// 存储枚举值QVariant enumVariant = QVariant::fromValue(MyEnumClass::Option2);// 获取枚举值if (enumVariant.canConvert<MyEnumClass::MyEnum>()) {MyEnumClass::MyEnum retrievedEnum = enumVariant.value<MyEnumClass::MyEnum>();qDebug() << "Retrieved enum value:" << retrievedEnum;}return 0;
}#include "main.moc"

2.5.类型检查与转换

QVariant 提供了一些方法来检查其存储的数据类型，并进行类型转换。

#include <QVariant>
#include <QDebug>int main() {QVariant variant = 42;if (variant.type() == QVariant::Int) {qDebug() << "The variant contains an integer.";}if (variant.canConvert(QVariant::String)) {qDebug() << "The variant can be converted to a string.";}return 0;
}

类型转换

#include <QVariant>
#include <QDebug>int main() {QVariant variant = 42;// 转换为字符串QString stringValue = variant.toString();qDebug() << "Converted to string:" << stringValue;return 0;
}

2.6.容器类型的存储与获取

QVariant 也可以存储 Qt 的容器类型，如 QList、QMap 等。

#include <QVariant>
#include <QList>
#include <QDebug>int main() {// 存储QListQList<int> intList = {1, 2, 3};QVariant listVariant = QVariant::fromValue(intList);// 获取QListif (listVariant.canConvert<QList<int>>()) {QList<int> retrievedList = listVariant.value<QList<int>>();for (int value : retrievedList) {qDebug() << "List value:" << value;}}return 0;
}

3.枚举的问题

假设我们有一个简单的枚举类型：

class EnumValue {
public:enum Values {V1 = 100,V2,V3};
};

我们希望将EnumValue::Values枚举类型存储在QVariant中，并在需要时将其取出。我们可能会尝试以下代码：

QVariant var = EnumValue::V1;
EnumValue::Values ev = var.value<EnumValue::Values>();
qDebug() << "var = " << ev;

不幸的是，这段代码会导致编译错误：

错误: 'qt_metatype_id' is not a member of 'QMetaTypeId<EnumValue::Values>'

问题的根源

这个错误的根本原因是，QVariant在存储和取出数据时，依赖于Qt的元对象系统。为了能够正确地存储和取出自定义类型（包括枚举类型），这些类型必须被Qt的元对象系统所识别。枚举类型默认情况下并没有被Qt的元对象系统处理，因此QVariant无法直接存储和取出枚举类型。

解决方案

方法一：强制类型转换

一种简单的解决方法是使用强制类型转换。由于枚举类型本质上是一个整数，我们可以将QVariant中的值转换为int，然后再将其转换为枚举类型：

QVariant var = EnumValue::V1;
EnumValue::Values ev = static_cast<EnumValue::Values>(var.toInt());
qDebug() << "var = " << ev;

这种方法虽然可行，但它看起来不够优雅，并且容易出错。

方法二：使用Q_DECLARE_METATYPE宏

为了更优雅地解决这个问题，Qt提供了一个宏Q_DECLARE_METATYPE，它可以将自定义类型（包括枚举类型）注册到Qt的元对象系统中。我们只需要在枚举类型定义之后添加这个宏：

class EnumValue {
public:enum Values {V1 = 100,V2,V3};
};Q_DECLARE_METATYPE(EnumValue::Values)

然后，我们可以使用QVariant::fromValue()函数将枚举类型存储在QVariant中，并使用QVariant::value()函数将其取出：

QVariant var = QVariant::fromValue(EnumValue::V1);
EnumValue::Values ev = var.value<EnumValue::Values>();
qDebug() << "var = " << ev;

这次，代码将正确输出100，表示我们成功地将枚举类型存储并从QVariant中取出。

4.信号槽中使用自定义结构体

4.1.使用QVariant转换

首先定义一个结构体：

// 定义自定义结构体
struct MyStruct {int id;QString name;
};

然后用Q_DECLARE_METATYPE(MyStruct)注册自定义结构体

定义一个结构体并发送：

MyStruct stInfo;
stInfo.id = 100;
stInfo.name = "214124";
emit sig_sendInfo(QVariant::fromValue(stInfo));

接收端槽函数处理如下：

connect(信号类指针, &信号类::sig_trainInfo, 槽函数指针, [=](QVariant var){if (var.canConvert<TRANS_DOT_INFO>()){MyStruct stInfo = var.value<MyStruct>();//...}});

4.2.直接传递自定义结构体

在使用 Q_DECLARE_METATYPE 宏声明该结构体为元类型，然后在使用信号槽之前调用 qRegisterMetaType 函数进行注册。

// 声明元类型
Q_DECLARE_METATYPE(MyStruct)// 在合适的地方（如 main 函数中）进行注册
int main(int argc, char *argv[]) {QApplication a(argc, argv);// 注册自定义结构体到元对象系统qRegisterMetaType<MyStruct>("MyStruct");// 后续代码...return a.exec();
}

完整的实例代码如下：

#include <QObject>
#include <QMetaType>
#include <QDebug>
#include <QApplication>// 定义自定义结构体
struct MyStruct {int id;QString name;
};// 声明元类型
Q_DECLARE_METATYPE(MyStruct)// 发送信号的类
class Sender : public QObject {Q_OBJECT
public:explicit Sender(QObject *parent = nullptr) : QObject(parent) {}signals:// 定义包含自定义结构体参数的信号void mySignal(const MyStruct &data);public slots:void sendData() {MyStruct data;data.id = 1;data.name = "Example";// 发射信号emit mySignal(data);}
};// 接收信号的类
class Receiver : public QObject {Q_OBJECT
public:explicit Receiver(QObject *parent = nullptr) : QObject(parent) {}public slots:// 定义槽函数void handleSignal(const MyStruct &data) {qDebug() << "Received data - ID:" << data.id << ", Name:" << data.name;}
};int main(int argc, char *argv[]) {QApplication a(argc, argv);// 注册自定义结构体到元对象系统qRegisterMetaType<MyStruct>("MyStruct");// 创建发送者和接收者对象Sender sender;Receiver receiver;// 连接信号和槽QObject::connect(&sender, &Sender::mySignal, &receiver, &Receiver::handleSignal);// 触发信号sender.sendData();return a.exec();
}#include "main.moc"

5.性能开销

QVariant 是 Qt 中一个用于存储多种不同数据类型的通用容器类，它为数据的存储和处理提供了很大的灵活性，但也带来了一定的性能开销，下面从几个方面详细分析：

5.1. 内存开销

  • 额外的元数据存储：QVariant 除了要存储实际的数据外，还需要存储关于该数据类型的元信息。这包括数据类型的标识（如 QMetaType::Type），用于在运行时识别存储的数据类型。这种额外的元数据存储会增加内存的使用量，尤其是在需要存储大量 QVariant 对象时，内存开销会更加明显。
  • 深拷贝问题：对于一些复杂的数据类型（如自定义类或容器），QVariant 在存储时可能会进行深拷贝。深拷贝意味着会复制整个对象及其所有成员，这会占用额外的内存空间。例如，当存储一个包含大量元素的 QList 时，QVariant 会复制该列表的所有元素，导致内存使用量显著增加。

5.2. 时间开销

  • 类型检查和转换：在使用 QVariant 时，经常需要进行类型检查和转换操作。例如，使用 canConvert 方法检查是否可以将 QVariant 转换为特定类型，以及使用 toXXX 系列方法（如 toInt、toString）进行类型转换。这些操作需要在运行时进行类型判断和转换逻辑，会带来一定的时间开销。特别是在频繁进行类型检查和转换的场景下，性能影响会更加突出。
    QVariant var = "123";if (var.canConvert<int>()) {int num = var.toInt();}
  • 构造和析构：创建和销毁 QVariant 对象也会有一定的时间开销。构造 QVariant 对象时，需要初始化其内部的元数据和存储数据；析构时，需要释放相关的资源。对于简单的数据类型，这种开销可能相对较小，但对于复杂的数据类型，开销会相应增加。

5.3. 与直接使用具体类型的对比

  • 性能差异：相比于直接使用具体的数据类型，QVariant 的性能要低很多。直接使用具体类型时，编译器可以进行更多的优化，并且不需要进行额外的类型检查和转换。例如，直接使用 int 类型进行计算的速度会比使用 QVariant 存储 int 类型并进行操作快得多。
    // 直接使用 int 类型int a = 10;int b = 20;int result = a + b;// 使用 QVariant 存储 int 类型QVariant varA = 10;QVariant varB = 20;if (varA.canConvert<int>() && varB.canConvert<int>()) {int resultVariant = varA.toInt() + varB.toInt();}
  • 适用场景：虽然 QVariant 存在性能开销，但在某些场景下它是非常有用的。例如，当需要处理多种不同类型的数据，或者在不同模块之间传递数据且数据类型不确定时，QVariant 可以提供很大的便利。但在对性能要求极高且数据类型明确的场景下，应尽量避免使用 QVariant。

6.总结

   QVariant 是 Qt 框架中一个极为实用的类，它为不同类型数据的存储与处理提供了统一的解决方案，不妨去试一试吧！


http://www.ppmy.cn/ops/166818.html

相关文章

走进Java：Integer128陷阱

走进Java：Integer128陷阱

❀❀❀ 大佬求个关注~祝您开心每一天 ❀❀❀ 目录 一、Integer和int的联系 1.1 Integer和int的区别 1.2 Integer和int的相互转换 二、装箱 三、拆箱 今天在学习Java的时候遇到了下面几个问题。 public static void main(String[] args) {Integer num1 127;Integer nu…
阅读更多...
34个适合机械工程及自动化专业【论文选题】

34个适合机械工程及自动化专业【论文选题】

论文选题具有极其重要的意义&#xff0c;它直接关系到论文的质量、价值以及研究的可行性和顺利程度。选题明确了研究的具体领域和核心问题&#xff0c;就像给研究旅程设定了方向和目的地。例如&#xff0c;选择 “人工智能在医疗影像诊断中的应用” 这一选题&#xff0c;就确定…
阅读更多...
算法竞赛-基础算法-位运算

算法竞赛-基础算法-位运算

目录 1.快速幂 2.快速乘 3.lowbit(n) 4.其他 5.相关题目 6.小结 引言&#xff1a;位运算的主要特点之一是在二进制表示下不进位&#xff0c;一下为一些基础的位运算操作&#xff1a; 与或非异或and,&or,|not,~xor 1.快速幂 快速幂的计算原理就是基于位运算&#x…
阅读更多...
C# Type类中Name、FullName、Namespace、AssemblyQualifiedName的区别

C# Type类中Name、FullName、Namespace、AssemblyQualifiedName的区别

总目录 前言 在C#中&#xff0c;Type 类提供了多种属性来获取类型的相关信息。以下是 Name、FullName、Namespace 和 AssemblyQualifiedName 这几个属性的区别和具体用途。 一、获取各名称属性示例 namespace ReflectionDemo {public class User { }internal class Program{s…
阅读更多...
使用yolov8+flask实现精美登录界面+图片视频摄像头检测系统

使用yolov8+flask实现精美登录界面+图片视频摄像头检测系统

这个是使用flask实现好看登录界面和友好的检测界面实现yolov8推理和展示&#xff0c;代码仅仅有2个html文件和一个python文件&#xff0c;真正做到了用最简洁的代码实现复杂功能。 测试通过环境&#xff1a; windows x64 anaconda3python3.8 ultralytics8.3.81 flask1.1.2…
阅读更多...
《大语言模型》学习笔记（三）

《大语言模型》学习笔记（三）

GPT系列模型的技术演变 2022 年11月底&#xff0c;OpenAI推出了基于大语言模型的在线对话应用—ChatGPT。由于具备出色的人机对话能力和任务解决能力&#xff0c;ChatGPT一经发布就引发了全社会对于大语言模型的广泛关注&#xff0c;众多的大语言模型应运而生&#xff0c;并且…
阅读更多...
优化Go错误码管理：构建清晰、优雅的HTTP和gRPC错误码规范

优化Go错误码管理：构建清晰、优雅的HTTP和gRPC错误码规范

在系统开发过程中&#xff0c;如何优雅地管理错误信息一直是个棘手问题。传统的错误处理方式往往存在不统一、难以维护等缺点。而 errcode 模块通过对错误码进行规范化管理&#xff0c;为系统级和业务级错误提供了统一的编码标准。本文将带您深入了解 errcode 的设计原理、错误…
阅读更多...
uni-app+SpringBoot: 前端传参，后端如何接收参数

uni-app+SpringBoot: 前端传参，后端如何接收参数

做项目中的一些小经验&#xff0c;方便后续 &#xff08;1&#xff09;前端代码中&#xff0c;请求的 URL 是通过查询参数&#xff08;?id${articleId}&#xff09;传递的 后端接口&#xff1a; GetMapping("/knowledgeDetail") public Result getKnowledgeByid(R…
阅读更多...
最新文章

Copyright @ 2022~2023