QVariant Internals: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
'''English''' [[QtVariant-SimplifiedChinese|简体中文]] [[QtVariant Bulgarian|Български]]
'''English''' [[QtVariant SimplifiedChinese|简体中文]] [[QtVariant_Bulgarian|Български]]<br />[[Category:QtInternals]]<br />[toc align_right=&quot;yes&amp;quot; depth=&quot;3&amp;quot;]


=QtVariant=
= QtVariant =


==Introduction==
== Introduction ==


In C++, a variable needs to have its type known at compile time. There are situations that however require us to deal with variables whose type is known only at run time. For example, let’s say you have a function that returns a value from the database. What would its return value be? In C, it would be a “void *” and an additional information would provide its type. Or assume that you allow the user to attach arbitrary information to the cells of your custom table widget. What type be the argument type for this function setUserCellData(type x)?
In C++, a variable needs to have its type known at compile time. There are situations that however require us to deal with variables whose type is known only at run time. For example, let's say you have a function that returns a value from the database. What would its return value be? In C, it would be a &quot;void '''&quot; and an additional information would provide its type. Or assume that you allow the user to attach arbitrary information to the cells of your custom table widget. What type be the argument type for this function setUserCellData(type x)?
<br />A QVariant can be used in the above situations and can be used to hold a value of any type. You can ask a QVariant for its type and handle the value stored inside it appropriately.
<br />Before understanding Qt's implementation, we will first try to see the various problems involved in designing the QVariant to appreciate the final solution better.
<br />h2. QVariant functionality requirements
<br /># QVariant should not (and cannot) be a template class. If QVariant is a template, every class that store a QVariant needs to become a template.<br /># QVariant must work for both POD and non-POD data types. It should work for any type that is copyable and behaves as a value based type. Note that the support for non-POD types means that one cannot use a C union to hold all known types since C++ disallows placing non-POD types in a union.<br /># QVariant must be able to store custom user types. So, if you write a MyStruct, you should be able to place it in a QVariant.<br /># QVariant should (and cannot) not use C++ RTTI. In C+'', RTTI only works with polymorphic classes.
<br />h2. Storing the value as 'void ''''
<br />An idea would be to hold a 'void'''' and a type inside QVariant. We can have a QVariant constructor as a function template that can just fit in any type. Like:<br /><code>
<br />class QVariant<br />{<br />private:<br />union {<br /> // POD data types<br /> int i;<br /> float f;<br /> // All non-POD data types are stored as void *.<br /> void '''v;<br />} data;
<br /> enum DataType { Integer, Float, NonPod }; // the type of data<br /> int type;<br />public:<br />// Constuctors for built-in/POD data types<br />QVariant(int i)<br />{<br /> data.i = i;<br /> type = Integer;<br />}
<br />// For all the non-POD types have a template constructor<br />template &lt;typename T&amp;gt;<br />QVariant(const T &amp;amp;t)<br />{<br /> data.v = (void''') new T (t);<br /> type = NonPod;<br /> …<br />}<br /></code>
<br />However, we will have trouble writing the destructor. How does one 'delete' the void pointer? In C''+ you cannot delete a 'void''''.


A QVariant can be used in the above situations and can be used to hold a value of any type. You can ask a QVariant for its type and handle the value stored inside it appropriately.
== Arriving at the solution ==
 
Before understanding Qt’s implementation, we will first try to see the various problems involved in designing the QVariant to appreciate the final solution better.
 
==QVariant functionality requirements==
 
# QVariant should not (and cannot) be a template class. If QVariant is a template, every class that store a QVariant needs to become a template.
# QVariant must work for both <span class="caps">POD</span> and non-<span class="caps">POD</span> data types. It should work for any type that is copyable and behaves as a value based type. Note that the support for non-<span class="caps">POD</span> types means that one cannot use a C union to hold all known types since C++ disallows placing non-<span class="caps">POD</span> types in a union.
# QVariant must be able to store custom user types. So, if you write a MyStruct, you should be able to place it in a QVariant.
# QVariant should (and cannot) not use C++ <span class="caps">RTTI</span>. In C++, <span class="caps">RTTI</span> only works with polymorphic classes.
 
==Storing the value as ‘void *’==
 
An idea would be to hold a ‘void *’ and a type inside QVariant. We can have a QVariant constructor as a function template that can just fit in any type. Like:<br />
 
However, we will have trouble writing the destructor. How does one ‘delete’ the void pointer? In C++ you cannot delete a ‘void *’.
 
==Arriving at the solution==


As we can deduce from above, to delete the void * we simply need to know the type. And since QVariant needs to support user defined types it is not possible to put a huge switch case to reinterpret_cast the void * to a specific type and delete the pointer.
As we can deduce from above, to delete the void * we simply need to know the type. And since QVariant needs to support user defined types it is not possible to put a huge switch case to reinterpret_cast the void * to a specific type and delete the pointer.


We also have a problem when trying to access the content of the QVariant. variant.value&lt;MyStruct&gt;() should not crash under any circumstance. If a conversion is not possible, it should return a default constructed MyStruct.
We also have a problem when trying to access the content of the QVariant. variant.value&amp;lt;MyStruct&amp;gt;() should not crash under any circumstance. If a conversion is not possible, it should return a default constructed MyStruct.
 
The solution is to have a system that can construct a value from a void *, destroy a void * and cast a void * type to access the value. If we have functions for these tasks for ''every'' type that can be stored in a QVariant, then QVariant can use these functions to work on the void *.
 
qMetaTypeConstructHelper and qMetaTypeDeleteHelper are the template construction helpers<br /> qRegisterMetaType&lt;MyStruct&gt;(“MyStruct”) —- QMetaType::registerType(“MyStruct”, ctr, dtr); —- Internally it’s all stored in a QVector&lt;QCustomTypeInfo&gt;
 
If you do qRegisterMetaType for all types, we are done! But it’s a pain?<br /> Q_DECLARE_METATYPE(Type) —— Create a class QMetaTypeId that provides qt_metatype_id() that registers on demand.


—- Provides a function
The solution is to have a system that can construct a value from a void ''', destroy a void''' and cast a void * type to access the value. If we have functions for these tasks for ''every'' type that can be stored in a QVariant, then QVariant can use these functions to work on the void *.


qMetaTypeId provides compile time look up of a type’s id
qMetaTypeConstructHelper and qMetaTypeDeleteHelper are the template construction helpers<br />qRegisterMetaType&amp;lt;MyStruct&amp;gt;(&quot;MyStruct&amp;quot;)<br /> — QMetaType::registerType(&quot;MyStruct&amp;quot;, ctr, dtr);<br /> — Internally it's all stored in a QVector&amp;lt;QCustomTypeInfo&amp;gt;


===Categories:===
If you do qRegisterMetaType for all types, we are done! But it's a pain?<br />Q_DECLARE_METATYPE(Type)<br /> —- Create a class QMetaTypeId that provides qt_metatype_id() that registers on demand.


* [[:Category:QtInternals|QtInternals]]
— Provides a function

Revision as of 10:23, 24 February 2015

English 简体中文 Български

[toc align_right="yes&quot; depth="3&quot;]

QtVariant

Introduction

In C++, a variable needs to have its type known at compile time. There are situations that however require us to deal with variables whose type is known only at run time. For example, let's say you have a function that returns a value from the database. What would its return value be? In C, it would be a "void " and an additional information would provide its type. Or assume that you allow the user to attach arbitrary information to the cells of your custom table widget. What type be the argument type for this function setUserCellData(type x)?
A QVariant can be used in the above situations and can be used to hold a value of any type. You can ask a QVariant for its type and handle the value stored inside it appropriately.
Before understanding Qt's implementation, we will first try to see the various problems involved in designing the QVariant to appreciate the final solution better.
h2. QVariant functionality requirements
# QVariant should not (and cannot) be a template class. If QVariant is a template, every class that store a QVariant needs to become a template.
# QVariant must work for both POD and non-POD data types. It should work for any type that is copyable and behaves as a value based type. Note that the support for non-POD types means that one cannot use a C union to hold all known types since C++ disallows placing non-POD types in a union.
# QVariant must be able to store custom user types. So, if you write a MyStruct, you should be able to place it in a QVariant.
# QVariant should (and cannot) not use C++ RTTI. In C+, RTTI only works with polymorphic classes.
h2. Storing the value as 'void '


An idea would be to hold a 'void' and a type inside QVariant. We can have a QVariant constructor as a function template that can just fit in any type. Like:

<br />class QVariant<br />{<br />private:<br />union {<br /> // POD data types<br /> int i;<br /> float f;<br /> // All non-POD data types are stored as void *.<br /> void '''v;<br />} data;
<br /> enum DataType { Integer, Float, NonPod }; // the type of data<br /> int type;<br />public:<br />// Constuctors for built-in/POD data types<br />QVariant(int i)<br />{<br /> data.i = i;<br /> type = Integer;<br />}
<br />// For all the non-POD types have a template constructor<br />template &lt;typename T&amp;gt;<br />QVariant(const T &amp;amp;t)<br />{<br /> data.v = (void''') new T (t);<br /> type = NonPod;<br /> …<br />}<br />


However, we will have trouble writing the destructor. How does one 'delete' the void pointer? In C+ you cannot delete a 'void''.

Arriving at the solution

As we can deduce from above, to delete the void * we simply need to know the type. And since QVariant needs to support user defined types it is not possible to put a huge switch case to reinterpret_cast the void * to a specific type and delete the pointer.

We also have a problem when trying to access the content of the QVariant. variant.value&lt;MyStruct&gt;() should not crash under any circumstance. If a conversion is not possible, it should return a default constructed MyStruct.

The solution is to have a system that can construct a value from a void , destroy a void and cast a void * type to access the value. If we have functions for these tasks for every type that can be stored in a QVariant, then QVariant can use these functions to work on the void *.

qMetaTypeConstructHelper and qMetaTypeDeleteHelper are the template construction helpers
qRegisterMetaType&lt;MyStruct&gt;("MyStruct&quot;)
— QMetaType::registerType("MyStruct&quot;, ctr, dtr);
— Internally it's all stored in a QVector&lt;QCustomTypeInfo&gt;

If you do qRegisterMetaType for all types, we are done! But it's a pain?
Q_DECLARE_METATYPE(Type)
—- Create a class QMetaTypeId that provides qt_metatype_id() that registers on demand.

— Provides a function