QtInternal 之 QVariant

本文深入探讨了Qt中QtVariant的特性和设计原则,包括如何处理运行时未知类型的变量,支持不同类型数据存储以及如何实现通用的构造函数和销毁函数。

注意:本文翻译自  http://developer.qt.nokia.com   中的  QtVariant   ,中文译文见  简体中文版 ,如果你对翻译wiki感兴趣,请参考Wiki中文帮助

注:QtInternal 系列是用来介绍Qt的各种特性是如何设计和实现的。

简介

在C++中,变量的类型需要在编译期就是已知的。但是在一些情况下我们需要处理一些类型在运行期才可知的变量。比如,假设你有一个函数,其返回从数据库中获得的值。那么其返回值什么呢?在C中,这将是一个 “void*” 和一个额外的提供它的类型的信息。再或者假设你允许用户附加任意信息到那你的自定义表格控件的单元格。那么这个函数 setUserCellData(type X)的参数类型是什么呢?

QVariant可用于上述情况,它可用于保存任何类型的值。你可以向QVariant询问类型和它内部存储的值。

在理解Qt的实现之前,为了更好地欣赏最终的解决方案我们会先尝试看看在QVariant的设计中所涉及的各种问题。

QVariant 功能需求

  1. QVariant 不应当(也不能)是一个模板类。如果 QVariant 是一个模板,每一个存储 QVariant 的类也需要成为一个模板。
  2. QVariant 必须对POD 和 非POD 数据类型都能工作。它应当对每一个可拷贝的和有着值行为的数据类型都能工作。请注意,对非POD类型的支持意味着我们不能使用C union来存储所有已知的类型,因为C ++不允许在union中放置非POD类型。
  3. QVariant 必须能够存放用户自定义类型。所以,如果你写了一个 Mytruct,你应当能够将其放入到QVariant。
  4. QVariant 不应当(也不能)使用 C++ 的 RTTI。在 C++ 中 RTTI 只对多态的类有效。

数据存储为 'void *'

一个想法是在QVariant内部维护一个"void *"和类型。我们可以有一个可以适合任何类型的函数模板作为QVariant的一个构造函数。像这样:

class QVariant 
{
private:
union { 
    // POD 数据类型
    int i; 
    float f; 
    // 所有 非POD 数据类型存储为 void *
    void *v; 
} data;

    enum DataType { Integer, Float, NonPod }; // 数据的类型
    int type;
public:
// 适合 内置/POD 数据类型的构造函数
QVariant(int i) 
{ 
    data.i = i; 
    type = Integer;
}

// 为所有非 non-POD 类型准备的模板构造函数
template <typename T>
QVariant(const T &amp;t)
{
    data.v = (void *) new T(t);
    type = NonPod;
    ...
}

尽管如此,我们写析构函数时将会遇到麻烦。如何 'delete' 这个 void 指针?在C++中,你不能删除一个 'void *'。

实现解决方案

正如我们上面得出的,要删除 void* 我们只需要简单地知道它的类型。此外,由于 QVariant 需要支持用户定义类型,我们不可能放置一个巨大的switch case 来将 void * 通过 reinterpret_cast 转换成特定的类型并删除这个指针。

当试图访问QVariant的内容时我们也会遇到问题。variant.value <MyStruct>() 在任何情况下都不应当崩溃。如果转换是不可用,它应该返回一个默认构造的MyStruct。

解决的办法是有一个这样的系统:可以从void *构造一个值,delete一个void *,并可通过转换 void * 类型来访问其值。如果对 _每一个_ 存储在 QVariant 中的类型都有这些函数,那么QVariant就可以使用这些函数在void* 上工作。

qMetaTypeConstructHelper 和 qMetaTypeDeleteHelper 是辅助的模板函数

qRegisterMetaType<MyStruct>("MyStruct")

  • QMetaType::registerType("MyStruct", ctr, dtr);

  • 内部所有东西都存储在 QVector<QCustomTypeInfo>

你是否需要对所有的类型执行 qRegisterMetaType,我们已经完成了。但是这很痛苦?

Q_DECLARE_METATYPE(Type)

  • 创建一个类 QMetaTypeId,它提供的 qt_metatype_id() 可根据要求进行注册。
  • 提供一个函数

qMetaTypeId 提供了编译期 类型 id 的查找。

参考

QVariantQt 框架中的一个非常重要的类,它提供了一种通用的数据类型,可以存储多种不同类型的数据。以下是关于 QVariant 的详细介绍及使用指南: ### 特性 - **通用性**:QVariant 可以存储多种不同类型的数据,包括基本数据类型(如 int、double、bool 等)、Qt 特有的数据类型(如 QColor、QPoint、QString 等)以及自定义类型(需要进行注册)。 - **类型安全**:QVariant 会记录存储数据的类型信息,在进行数据提取时可以进行类型检查,确保数据的正确提取。 - **隐式共享**:QVariant 使用隐式共享技术,这意味着在复制 QVariant 对象时,不会立即复制实际的数据,而是共享同一份数据,只有在需要修改数据时才会进行复制,从而提高了效率。 ### 使用方法 #### 存储数据 可以使用构造函数或 setValue() 方法将数据存储QVariant 对象中。 ```python #include <QVariant> #include <QString> #include <QDebug> int main() { // 使用构造函数存储数据 QVariant var1(42); QVariant var2("Hello, World!"); // 使用 setValue() 方法存储数据 QVariant var3; var3.setValue(3.14); return 0; } ``` #### 提取数据 可以使用 toXXX() 系列方法将存储QVariant 对象中的数据提取出来。在提取数据时,需要确保提取的类型与存储的类型一致,否则可能会得到错误的结果。 ```python #include <QVariant> #include <QString> #include <QDebug> int main() { QVariant var1(42); QVariant var2("Hello, World!"); QVariant var3(3.14); int intValue = var1.toInt(); QString stringValue = var2.toString(); double doubleValue = var3.toDouble(); qDebug() << "Int value: " << intValue; qDebug() << "String value: " << stringValue; qDebug() << "Double value: " << doubleValue; return 0; } ``` #### 检查数据类型 可以使用 type() 方法或 typeName() 方法来检查 QVariant 对象中存储的数据类型。 ```python #include <QVariant> #include <QDebug> int main() { QVariant var(42); QVariant::Type type = var.type(); const char* typeName = var.typeName(); qDebug() << "Type: " << type; qDebug() << "Type name: " << typeName; return 0; } ``` ### 应用场景 - **数据存储和传递**:在不同模块或函数之间传递数据时,QVariant 可以作为一种通用的数据容器,方便地存储和传递不同类型的数据。 - **配置文件读写**:在读写配置文件时,QVariant 可以用来存储和读取不同类型的配置信息,如整数、字符串、布尔值等。 - **数据库操作**:在进行数据库操作时,QVariant 可以用来存储从数据库中查询到的数据,方便进行处理和显示。 在参考引用中提到,Qt 读取 Excel 之后,数据存储QVariant var 中,后续可将 QVariant 中的数据读进 `QList<QList<MyType>>` 以及 `QList<MyType>` 中,这也是 QVariant 在实际应用中的一个场景 [^1]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值