qt -- QVariant 类

kenson

1、 QVariant 类用于封装数据成员的类型及取值等信息，该类类似于 C++ 共用体 union ，一个QVariant 对象，一次只能保存一个单一类型的值。该类封装了 Qt 中常用的类型，对于 QVariant 不支持的类型 ( 比如用户自定义类型 ) ，则需要 使 用 Q_DECLARE_METATYPE( Type )宏进行注册。
& I$ y7 V) g1 i' }2、QVariant 拥有常用类型的单形参构造函数，因此可把这些常用类型转换为 QVariant 类型，同时 QVariant 还重载了赋值运算符，因此可把常用类型的值直接赋给 QVariant 对象。注：由 C++语法可知，单形参构造函数可进行类型转换。
3、使用 QVariant 构造函数和赋值运算符。
, v1 o7 o/ ^* y$ Z$ |注意： QVariant 没有 char 类型的构造函数，若使用 char 值会被转换为对应的 int 型。
QVariant v(1); // 调用 QVariant(int) 构造函数创建一个 QVariant 类型的对象，并把数值 1 保存到 v 中。
v=2; // 调用 QVariant 的赋值运算符，把值 2 保存在 v 之中，因为 QVariant 是类似于共用体的类， 因此同一时间只会保存一个值。

' ]! }8 Q4 P/ H; z2 Z$ {$ Y4、 获取 QVariant 对象存储的值的类型，可使用如下函数：
Type type() const
获取 QVariant 对象当前存储值的类型，类型以枚举 QMetaType::Type 的形式表示
1 Y) Y5 ?' e" S
const char * typeName() const;
以字符串的形式返回 QVariant 对象存储的值的类型。若是无效类型则返回 0 。
) E- n9 p  V/ b- x4 X' _( a* jconst char* typeToName(int t);
/ d9 ?' k9 j6 ]# @把以枚举类型 QMetaType::Type 表示的类型以字符串的形式返回。若枚举值QMetaType::
UnknownType 或不存在，则返回一个空指针。
5 q. c, L7 p5 t: Z7 l( o8 ~
示例：
; M4 h( }* @* d( C

• 
  * }3 I# C8 z# Z7 h. L- u; m
  4 O3 k$ g( l5 C5 J8 i! _QVariant v(1);
  
  ! q3 W& _* e  r$ q5 H* H) h0 F
• 
  
  cout<<v.typeName()<<endl; //输出 int
  
  
• 
  & f& v0 n& N  M
  3 ^% ~8 G6 I1 |- J* s9 {cout<<v.typeToName(v.type())<<endl; //输出 int
  - @) @9 D, m7 p
  4 Z. W6 w* [& d& I7 \5 E
  % g2 B9 T9 _, @3 ?6 ?4 J# F* v

* X, L* V4 Y* w# f# ^( f5 c* J6 D

5、获取和设置 QVariant 对象存储的值，可使用如下函数：

void setValue(const T& v);

把一个值的副本存储到 QVariant 对象中，若类型 T 是 QVariant 不支持的类型，则使用 QMetaType 来存储该值，若 QMetaType 也不能处理，则发生编译错误。注：若是用户

自定义类型则需要使用宏 Q_DECLARE_METATYPE(…) 进行注册

T value() const;

把存储的值转换为类型 T 并返回转换后的值，存储值本身不会被改变。若 T 是 QVariant 支持的类型，则该函数与 toInt 、 toString 等函数功能完全相同。注：使用该函数时需要使用尖括号指定 T 的类型，比如 xx.value<int>();

  T toT()

其中 T 是某一类型，比如若 T 是 int ，则该函数形式就为 int toInt() 。

该函数用于把存储的值转换为类型 T 并返回转换后的值，存储值本身不会被改变。 其中比较常用的是 toString 函数，该函数可把存储的值转换为 QString 形式，这样 便可以字符串的形式输出存储的值。

注意：没有与自定义类型相对应的 toT 函数，比如 class C{}; 则没有 toC 函数，要

把存储的值转换为自定义类型，需要使用 value 函数，且还需对自定义类型注册。

6、 注意：QVariant 中的枚举类型 Type 已被废弃。

6 }4 g6 i- }+ H4 F) `) Q

7、使用 QVariant 的默认构造函数，将创建一个无效的 QVariant 对象(或空的 QVariant 对象)， 可通过 isNull()成员函数进行判断。

9 l, H( X, |( P! H/ P- V

QVariant v('a'); /*QVariant 没有专门的 char 构造函数，此处的字符 a 会被转换为 int 型，因此 v

中存储的是数值 97，而不是字符 a 。*/

cout<<v.value<int>()<<endl; //输出 97

cout<<v.value<char>()<<endl; //输出 a，将 97 转换为 char 型，并输出转换后的值。

1 y4 s( [+ K. i5 o/ s+ k4 N! R' n

cout<<v.toChar().toLatin1()<<endl; /*输出 a，原因同上，注意 toChar 返回的类型是 QChar 而不

是 char。*/

/ b) Y8 c. s( p7 O! E9 e; `

cout<<v.toString().toStdString()<<endl; /*输出 97，把存储在 v 中的值转换为 QString，然后以字

符串形式输出。*/

. D. M; _, p6 M. k; y) d% X

cout<<v.typeName()<<endl; //输出 int，可见存储在 v 中的值的类型为 int

cout<<v.typeToName(v.type())<<endl; /*输出 int，其中 type 返回存储值的枚举形式表示的类型，而

typeToName 则以字符串形式显示该枚举值所表示的类型。*/

char c='b';

v.setValue(c);

cout<<v.toString().toStdString()<<endl; //输出 b

# C" ^9 |, `) K+ I1 [/ y" |

cout<<v.typeName()<<endl; /*输出 char，若是使用 QVariant 构造函数和直接赋值 char 型字符，此

处会输出 int，这是 setValue 与他们的区别。*/

& E* |& w, u2 S5 `9 G/ b

C mc; //自定义类型 C 的对象 mc

# B$ \6 P2 g/ |; z

//QVariant v1(mc); //错误，没有相应的构造函数。

QVariant v2;

//v2=mc; //错误，没有与类型 C 匹配的赋值运算符函数。

//v2.setValue(mc); //错误，自定义类型 C 未使用宏 Q_DECLARE_METATYPE

7 M4 F# d7 Q, G+ _6 H  A' Y