<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> <html><head><title>QVariant Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm } a:link { color: #004faf; text-decoration: none } a:visited { color: #672967; text-decoration: none } td.postheader { font-family: sans-serif } tr.address { font-family: sans-serif } body { background: #ffffff; color: black; } </style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QVariant Class Reference<br /><sup><sup>[<a href="qtcore.html">QtCore</a> module]</sup></sup></h1><p>The QVariant class acts like a union for the most common Qt data types. <a href="#details">More...</a></p> <h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qvariant.html#Type-enum">Type</a></b> { Invalid, Bool, Int, UInt, ..., UserType }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qvariant.html#QVariant">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-2">__init__</a></b> (<i>self</i>, Type <i>type</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-3">__init__</a></b> (<i>self</i>, int <i>typeOrUserType</i>, sip.voidptr <i>copy</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-4">__init__</a></b> (<i>self</i>, QVariant <i>other</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-5">__init__</a></b> (<i>self</i>, object)</li><li><div class="fn" />bool <b><a href="qvariant.html#canConvert">canConvert</a></b> (<i>self</i>, Type <i>t</i>)</li><li><div class="fn" /><b><a href="qvariant.html#clear">clear</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#convert">convert</a></b> (<i>self</i>, Type <i>t</i>)</li><li><div class="fn" />sip.voidptr <b><a href="qvariant.html#data">data</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#detach">detach</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isDetached">isDetached</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isNull">isNull</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isValid">isValid</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#load">load</a></b> (<i>self</i>, QDataStream <i>ds</i>)</li><li><div class="fn" /><b><a href="qvariant.html#save">save</a></b> (<i>self</i>, QDataStream <i>ds</i>)</li><li><div class="fn" /><b><a href="qvariant.html#swap">swap</a></b> (<i>self</i>, QVariant <i>other</i>)</li><li><div class="fn" />QBitArray <b><a href="qvariant.html#toBitArray">toBitArray</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#toBool">toBool</a></b> (<i>self</i>)</li><li><div class="fn" />QByteArray <b><a href="qvariant.html#toByteArray">toByteArray</a></b> (<i>self</i>)</li><li><div class="fn" />QChar <b><a href="qvariant.html#toChar">toChar</a></b> (<i>self</i>)</li><li><div class="fn" />QDate <b><a href="qvariant.html#toDate">toDate</a></b> (<i>self</i>)</li><li><div class="fn" />QDateTime <b><a href="qvariant.html#toDateTime">toDateTime</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool <i>ok</i>) <b><a href="qvariant.html#toDouble">toDouble</a></b> (<i>self</i>)</li><li><div class="fn" />QEasingCurve <b><a href="qvariant.html#toEasingCurve">toEasingCurve</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool <i>ok</i>) <b><a href="qvariant.html#toFloat">toFloat</a></b> (<i>self</i>)</li><li><div class="fn" />dict-of-QString-QVariant <b><a href="qvariant.html#toHash">toHash</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qvariant.html#toInt">toInt</a></b> (<i>self</i>)</li><li><div class="fn" />QLine <b><a href="qvariant.html#toLine">toLine</a></b> (<i>self</i>)</li><li><div class="fn" />QLineF <b><a href="qvariant.html#toLineF">toLineF</a></b> (<i>self</i>)</li><li><div class="fn" />list-of-QVariant <b><a href="qvariant.html#toList">toList</a></b> (<i>self</i>)</li><li><div class="fn" />QLocale <b><a href="qvariant.html#toLocale">toLocale</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qvariant.html#toLongLong">toLongLong</a></b> (<i>self</i>)</li><li><div class="fn" />dict-of-QString-QVariant <b><a href="qvariant.html#toMap">toMap</a></b> (<i>self</i>)</li><li><div class="fn" />QPoint <b><a href="qvariant.html#toPoint">toPoint</a></b> (<i>self</i>)</li><li><div class="fn" />QPointF <b><a href="qvariant.html#toPointF">toPointF</a></b> (<i>self</i>)</li><li><div class="fn" />object <b><a href="qvariant.html#toPyObject">toPyObject</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool <i>ok</i>) <b><a href="qvariant.html#toReal">toReal</a></b> (<i>self</i>)</li><li><div class="fn" />QRect <b><a href="qvariant.html#toRect">toRect</a></b> (<i>self</i>)</li><li><div class="fn" />QRectF <b><a href="qvariant.html#toRectF">toRectF</a></b> (<i>self</i>)</li><li><div class="fn" />QRegExp <b><a href="qvariant.html#toRegExp">toRegExp</a></b> (<i>self</i>)</li><li><div class="fn" />QSize <b><a href="qvariant.html#toSize">toSize</a></b> (<i>self</i>)</li><li><div class="fn" />QSizeF <b><a href="qvariant.html#toSizeF">toSizeF</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qvariant.html#toString">toString</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qvariant.html#toStringList">toStringList</a></b> (<i>self</i>)</li><li><div class="fn" />QTime <b><a href="qvariant.html#toTime">toTime</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qvariant.html#toUInt">toUInt</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qvariant.html#toULongLong">toULongLong</a></b> (<i>self</i>)</li><li><div class="fn" />QUrl <b><a href="qvariant.html#toUrl">toUrl</a></b> (<i>self</i>)</li><li><div class="fn" />Type <b><a href="qvariant.html#type">type</a></b> (<i>self</i>)</li><li><div class="fn" />str <b><a href="qvariant.html#typeName">typeName</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qvariant.html#userType">userType</a></b> (<i>self</i>)</li></ul><h3>Static Methods</h3><ul><li><div class="fn" />QVariant <b><a href="qvariant.html#fromList">fromList</a></b> (list-of-QVariant <i>list</i>)</li><li><div class="fn" />QVariant <b><a href="qvariant.html#fromMap">fromMap</a></b> (dict-of-QString-QVariant <i>map</i>)</li><li><div class="fn" />Type <b><a href="qvariant.html#nameToType">nameToType</a></b> (str <i>name</i>)</li><li><div class="fn" />str <b><a href="qvariant.html#typeToName">typeToName</a></b> (Type <i>type</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qvariant.html#__eq__">__eq__</a></b> (<i>self</i>, QVariant <i>v</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#__ne__">__ne__</a></b> (<i>self</i>, QVariant <i>v</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>Any Python object may be used whenever a <a href="qvariant.html">QVariant</a> is expected. None will be interpreted as an invalid QVariant.</p> <p>The QVariant class acts like a union for the most common Qt data types.</p> <p>Because C++ forbids unions from including types that have non-default constructors or destructors, most interesting Qt classes cannot be used in unions. Without QVariant, this would be a problem for <a href="qobject.html#property">QObject.property</a>() and for database work, etc.</p> <p>A QVariant object holds a single value of a single <a href="qvariant.html#type">type</a>() at a time. (Some <a href="qvariant.html#type">type</a>()s are multi-valued, for example a string list.) You can find out what type, T, the variant holds, convert it to a different type using <a href="qvariant.html#convert">convert</a>(), get its value using one of the toT() functions (e.g., <a href="qvariant.html#toSize">toSize</a>()) and check whether the type can be converted to a particular type using <a href="qvariant.html#canConvert">canConvert</a>().</p> <p>The methods named toT() (e.g., <a href="qvariant.html#toInt">toInt</a>(), <a href="qvariant.html#toString">toString</a>()) are const. If you ask for the stored type, they return a copy of the stored object. If you ask for a type that can be generated from the stored type, toT() copies and converts and leaves the object itself unchanged. If you ask for a type that cannot be generated from the stored type, the result depends on the type; see the function documentation for details.</p> <p>Here is some example code to demonstrate the use of QVariant:</p> <pre class="cpp"> <span class="type"><a href="qdatastream.html">QDataStream</a></span> out(<span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>); <span class="type">QVariant</span> v(<span class="number">123</span>); <span class="comment">// The variant now contains an int</span> <span class="type">int</span> x <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>(); <span class="comment">// x = 123</span> out <span class="operator"><</span><span class="operator"><</span> v; <span class="comment">// Writes a type tag and an int to out</span> v <span class="operator">=</span> <span class="type">QVariant</span>(<span class="string">"hello"</span>); <span class="comment">// The variant now contains a QByteArray</span> v <span class="operator">=</span> <span class="type">QVariant</span>(tr(<span class="string">"hello"</span>)); <span class="comment">// The variant now contains a QString</span> <span class="type">int</span> y <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>(); <span class="comment">// y = 0 since v cannot be converted to an int</span> <span class="type"><a href="qstring.html">QString</a></span> s <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toString">toString</a>(); <span class="comment">// s = tr("hello") (see QObject.tr())</span> out <span class="operator"><</span><span class="operator"><</span> v; <span class="comment">// Writes a type tag and a QString to out</span> <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> <span class="type"><a href="qdatastream.html">QDataStream</a></span> in(<span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>); <span class="comment">// (opening the previously written stream)</span> in <span class="operator">></span><span class="operator">></span> v; <span class="comment">// Reads an Int variant</span> <span class="type">int</span> z <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>(); <span class="comment">// z = 123</span> <a href="qtcore.html#qDebug">qDebug</a>(<span class="string">"Type is %s"</span><span class="operator">,</span> <span class="comment">// prints "Type is int"</span> v<span class="operator">.</span>typeName()); v <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>() <span class="operator">+</span> <span class="number">100</span>; <span class="comment">// The variant now hold the value 223</span> v <span class="operator">=</span> <span class="type">QVariant</span>(<span class="type"><a href="qstringlist.html">QStringList</a></span>()); </pre> <p>You can even store <a href="qlist.html">QList</a><QVariant> and <a href="qmap.html">QMap</a><<a href="qstring.html">QString</a>, QVariant> values in a variant, so you can easily construct arbitrarily complex data structures of arbitrary types. This is very powerful and versatile, but may prove less memory and speed efficient than storing specific types in standard data structures.</p> <p>QVariant also supports the notion of null values, where you can have a defined type with no value set. However, note that QVariant types can only be cast when they have had a value set.</p> <pre class="cpp"> <span class="type">QVariant</span> x<span class="operator">,</span> y(<span class="type"><a href="qstring.html">QString</a></span>())<span class="operator">,</span> z(<span class="type"><a href="qstring.html">QString</a></span>(<span class="string">""</span>)); x<span class="operator">.</span><a href="qvariant.html#convert">convert</a>(<span class="type">QVariant</span><span class="operator">.</span>Int); <span class="comment">// x.isNull() == true</span> <span class="comment">// y.isNull() == true, z.isNull() == false</span> </pre> <p>QVariant can be extended to support other types than those mentioned in the <a href="qvariant.html#Type-enum">Type</a> enum. See the <a href="qmetatype.html">QMetaType</a> documentation for details.</p> <a id="a-note-on-gui-types" name="a-note-on-gui-types" /> <h3>A Note on GUI Types</h3> <p>Because QVariant is part of the <a href="qtcore.html">QtCore</a> library, it cannot provide conversion functions to data types defined in <a href="qtgui.html">QtGui</a>, such as <a href="qcolor.html">QColor</a>, <a href="qimage.html">QImage</a>, and <a href="qpixmap.html">QPixmap</a>. In other words, there is no <tt>toColor()</tt> function. Instead, you can use the <a href="qvariant.html#value">QVariant.value</a>() or the <a href="qvariant.html#qvariant_cast">qvariant_cast</a>() template function. For example:</p> <pre class="cpp"> <span class="type">QVariant</span> variant; <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> <span class="type"><a href="qcolor.html">QColor</a></span> color <span class="operator">=</span> variant<span class="operator">.</span>value<span class="operator"><</span><span class="type"><a href="qcolor.html">QColor</a></span><span class="operator">></span>(); </pre> <p>The inverse conversion (e.g., from <a href="qcolor.html">QColor</a> to QVariant) is automatic for all data types supported by QVariant, including GUI-related types:</p> <pre class="cpp"> <span class="type"><a href="qcolor.html">QColor</a></span> color <span class="operator">=</span> palette()<span class="operator">.</span>background()<span class="operator">.</span>color(); <span class="type">QVariant</span> variant <span class="operator">=</span> color; </pre> <a id="using-canconvert-and-convert-consecutively" name="using-canconvert-and-convert-consecutively" /> <h3>Using canConvert() and convert() Consecutively</h3> <p>When using <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>() consecutively, it is possible for <a href="qvariant.html#canConvert">canConvert</a>() to return true, but <a href="qvariant.html#convert">convert</a>() to return false. This is typically because <a href="qvariant.html#canConvert">canConvert</a>() only reports the general ability of QVariant to convert between types given suitable data; it is still possible to supply data which cannot actually be converted.</p> <p>For example, <a href="qvariant.html#canConvert">canConvert</a>() would return true when called on a variant containing a string because, in principle, QVariant is able to convert strings of numbers to integers. However, if the string contains non-numeric characters, it cannot be converted to an integer, and any attempt to convert it will fail. Hence, it is important to have both functions return true for a successful conversion.</p> <hr /><h2>Type Documentation</h2><h3 class="fn"><a name="Type-enum" />QVariant.Type</h3><p>This enum type defines the types of variable that a <a href="qvariant.html">QVariant</a> can contain.</p> <table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QVariant.Invalid</tt></td> <td class="topAlign"><tt>0</tt></td> <td class="topAlign">no type</td> </tr> <tr> <td class="topAlign"><tt>QVariant.BitArray</tt></td> <td class="topAlign"><tt>13</tt></td> <td class="topAlign">a <a href="qbitarray.html">QBitArray</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Bitmap</tt></td> <td class="topAlign"><tt>73</tt></td> <td class="topAlign">a <a href="qbitmap.html">QBitmap</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Bool</tt></td> <td class="topAlign"><tt>1</tt></td> <td class="topAlign">a bool</td> </tr> <tr> <td class="topAlign"><tt>QVariant.Brush</tt></td> <td class="topAlign"><tt>66</tt></td> <td class="topAlign">a <a href="qbrush.html">QBrush</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.ByteArray</tt></td> <td class="topAlign"><tt>12</tt></td> <td class="topAlign">a <a href="qbytearray.html">QByteArray</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Char</tt></td> <td class="topAlign"><tt>7</tt></td> <td class="topAlign">a <a href="qchar.html">QChar</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Color</tt></td> <td class="topAlign"><tt>67</tt></td> <td class="topAlign">a <a href="qcolor.html">QColor</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Cursor</tt></td> <td class="topAlign"><tt>74</tt></td> <td class="topAlign">a <a href="qcursor.html">QCursor</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Date</tt></td> <td class="topAlign"><tt>14</tt></td> <td class="topAlign">a <a href="qdate.html">QDate</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.DateTime</tt></td> <td class="topAlign"><tt>16</tt></td> <td class="topAlign">a <a href="qdatetime.html">QDateTime</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Double</tt></td> <td class="topAlign"><tt>6</tt></td> <td class="topAlign">a double</td> </tr> <tr> <td class="topAlign"><tt>QVariant.EasingCurve</tt></td> <td class="topAlign"><tt>29</tt></td> <td class="topAlign">a <a href="qeasingcurve.html">QEasingCurve</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Font</tt></td> <td class="topAlign"><tt>64</tt></td> <td class="topAlign">a <a href="qfont.html">QFont</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Hash</tt></td> <td class="topAlign"><tt>28</tt></td> <td class="topAlign">a <a href="qvariant.html#QVariantHash-typedef">QVariantHash</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Icon</tt></td> <td class="topAlign"><tt>69</tt></td> <td class="topAlign">a <a href="qicon.html">QIcon</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Image</tt></td> <td class="topAlign"><tt>70</tt></td> <td class="topAlign">a <a href="qimage.html">QImage</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Int</tt></td> <td class="topAlign"><tt>2</tt></td> <td class="topAlign">an int</td> </tr> <tr> <td class="topAlign"><tt>QVariant.KeySequence</tt></td> <td class="topAlign"><tt>76</tt></td> <td class="topAlign">a <a href="qkeysequence.html">QKeySequence</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Line</tt></td> <td class="topAlign"><tt>23</tt></td> <td class="topAlign">a <a href="qline.html">QLine</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.LineF</tt></td> <td class="topAlign"><tt>24</tt></td> <td class="topAlign">a <a href="qlinef.html">QLineF</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.List</tt></td> <td class="topAlign"><tt>9</tt></td> <td class="topAlign">a <a href="qvariant.html#QVariantList-typedef">QVariantList</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Locale</tt></td> <td class="topAlign"><tt>18</tt></td> <td class="topAlign">a <a href="qlocale.html">QLocale</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.LongLong</tt></td> <td class="topAlign"><tt>4</tt></td> <td class="topAlign">a <a href="qtcore.html#qlonglong-typedef">qlonglong</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Map</tt></td> <td class="topAlign"><tt>8</tt></td> <td class="topAlign">a <a href="qvariant.html#QVariantMap-typedef">QVariantMap</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Matrix</tt></td> <td class="topAlign"><tt>80</tt></td> <td class="topAlign">a <a class="obsolete" href="qmatrix.html">QMatrix<sup>(obsolete)</sup></a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Transform</tt></td> <td class="topAlign"><tt>81</tt></td> <td class="topAlign">a <a href="qtransform.html">QTransform</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Matrix4x4</tt></td> <td class="topAlign"><tt>82</tt></td> <td class="topAlign">a <a href="qmatrix4x4.html">QMatrix4x4</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Palette</tt></td> <td class="topAlign"><tt>68</tt></td> <td class="topAlign">a <a href="qpalette.html">QPalette</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Pen</tt></td> <td class="topAlign"><tt>77</tt></td> <td class="topAlign">a <a href="qpen.html">QPen</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Pixmap</tt></td> <td class="topAlign"><tt>65</tt></td> <td class="topAlign">a <a href="qpixmap.html">QPixmap</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Point</tt></td> <td class="topAlign"><tt>25</tt></td> <td class="topAlign">a <a href="qpoint.html">QPoint</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.PointArray</tt></td> <td class="topAlign"><tt>Polygon</tt></td> <td class="topAlign">a <a href="porting4.html#qpointarray">QPointArray</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.PointF</tt></td> <td class="topAlign"><tt>26</tt></td> <td class="topAlign">a <a href="qpointf.html">QPointF</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Polygon</tt></td> <td class="topAlign"><tt>71</tt></td> <td class="topAlign">a <a href="qpolygon.html">QPolygon</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Quaternion</tt></td> <td class="topAlign"><tt>86</tt></td> <td class="topAlign">a <a href="qquaternion.html">QQuaternion</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Rect</tt></td> <td class="topAlign"><tt>19</tt></td> <td class="topAlign">a <a href="qrect.html">QRect</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.RectF</tt></td> <td class="topAlign"><tt>20</tt></td> <td class="topAlign">a <a href="qrectf.html">QRectF</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.RegExp</tt></td> <td class="topAlign"><tt>27</tt></td> <td class="topAlign">a <a href="qregexp.html">QRegExp</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Region</tt></td> <td class="topAlign"><tt>72</tt></td> <td class="topAlign">a <a href="qregion.html">QRegion</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Size</tt></td> <td class="topAlign"><tt>21</tt></td> <td class="topAlign">a <a href="qsize.html">QSize</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.SizeF</tt></td> <td class="topAlign"><tt>22</tt></td> <td class="topAlign">a <a href="qsizef.html">QSizeF</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.SizePolicy</tt></td> <td class="topAlign"><tt>75</tt></td> <td class="topAlign">a <a href="qsizepolicy.html">QSizePolicy</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.String</tt></td> <td class="topAlign"><tt>10</tt></td> <td class="topAlign">a <a href="qstring.html">QString</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.StringList</tt></td> <td class="topAlign"><tt>11</tt></td> <td class="topAlign">a <a href="qstringlist.html">QStringList</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.TextFormat</tt></td> <td class="topAlign"><tt>79</tt></td> <td class="topAlign">a <a href="qtextformat.html">QTextFormat</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.TextLength</tt></td> <td class="topAlign"><tt>78</tt></td> <td class="topAlign">a <a href="qtextlength.html">QTextLength</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Time</tt></td> <td class="topAlign"><tt>15</tt></td> <td class="topAlign">a <a href="qtime.html">QTime</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.UInt</tt></td> <td class="topAlign"><tt>3</tt></td> <td class="topAlign">a <a href="qtcore.html#uint-typedef">uint</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.ULongLong</tt></td> <td class="topAlign"><tt>5</tt></td> <td class="topAlign">a <a href="qtcore.html#qulonglong-typedef">qulonglong</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Url</tt></td> <td class="topAlign"><tt>17</tt></td> <td class="topAlign">a <a href="qurl.html">QUrl</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Vector2D</tt></td> <td class="topAlign"><tt>83</tt></td> <td class="topAlign">a <a href="qvector2d.html">QVector2D</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Vector3D</tt></td> <td class="topAlign"><tt>84</tt></td> <td class="topAlign">a <a href="qvector3d.html">QVector3D</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.Vector4D</tt></td> <td class="topAlign"><tt>85</tt></td> <td class="topAlign">a <a href="qvector4d.html">QVector4D</a></td> </tr> <tr> <td class="topAlign"><tt>QVariant.UserType</tt></td> <td class="topAlign"><tt>127</tt></td> <td class="topAlign">Base value for user-defined types.</td> </tr> </table> <hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QVariant" />QVariant.__init__ (<i>self</i>)</h3><p>Constructs an invalid variant.</p> <h3 class="fn"><a name="QVariant-2" />QVariant.__init__ (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a> <i>type</i>)</h3><p>Constructs a null variant of type <i>type</i>.</p> <h3 class="fn"><a name="QVariant-3" />QVariant.__init__ (<i>self</i>, int <i>typeOrUserType</i>, sip.voidptr <i>copy</i>)</h3><p>Constructs variant of type <i>typeOrUserType</i>, and initializes with <i>copy</i> if <i>copy</i> is not 0.</p> <p>Note that you have to pass the address of the variable you want stored.</p> <p>Usually, you never have to use this constructor, use <a href="qvariant.html#fromValue">QVariant.fromValue</a>() instead to construct variants from the pointer types represented by <tt>QMetaType.VoidStar</tt>, <tt>QMetaType.QObjectStar</tt> and <tt>QMetaType.QWidgetStar</tt>.</p> <p><b>See also</b> <a href="qvariant.html#fromValue">QVariant.fromValue</a>() and <a href="qvariant.html#Type-enum">Type</a>.</p> <h3 class="fn"><a name="QVariant-4" />QVariant.__init__ (<i>self</i>, QVariant <i>other</i>)</h3><h3 class="fn"><a name="QVariant-5" />QVariant.__init__ (<i>self</i>, object)</h3><p>Constructs a copy of the variant, <i>p</i>, passed as the argument to this constructor.</p> <h3 class="fn"><a name="canConvert" />bool QVariant.canConvert (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a> <i>t</i>)</h3><p>Returns true if the variant's type can be cast to the requested type, <i>t</i>. Such casting is done automatically when calling the <a href="qvariant.html#toInt">toInt</a>(), <a href="qvariant.html#toBool">toBool</a>(), ... methods.</p> <p>The following casts are done automatically:</p> <table class="generic"> <thead> <tr class="qt-style"> <th>Type</th> <th>Automatically Cast To</th> </tr> </thead> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Bool</a></td> <td><a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">ByteArray</a></td> <td><a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Char</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">Color</a></td> <td><a href="qvariant.html#Type-enum">String</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Date</a></td> <td><a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">String</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">DateTime</a></td> <td><a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">Time</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Double</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">Font</a></td> <td><a href="qvariant.html#Type-enum">String</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Int</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">KeySequence</a></td> <td><a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">List</a></td> <td><a href="qvariant.html#Type-enum">StringList</a> (if the list's items can be converted to strings)</td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">LongLong</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Point</a></td> <td><a href="qvariant.html#Type-enum">PointF</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">Rect</a></td> <td><a href="qvariant.html#Type-enum">RectF</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">String</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Color</a>, <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Font</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">KeySequence</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">StringList</a></td> <td><a href="qvariant.html#Type-enum">List</a>, <a href="qvariant.html#Type-enum">String</a> (if the list contains exactly one item)</td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">Time</a></td> <td><a href="qvariant.html#Type-enum">String</a></td> </tr> <tr class="even" valign="top"> <td><a href="qvariant.html#Type-enum">UInt</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td> </tr> <tr class="odd" valign="top"> <td><a href="qvariant.html#Type-enum">ULongLong</a></td> <td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a></td> </tr> </table> <p><b>See also</b> <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="clear" />QVariant.clear (<i>self</i>)</h3><p>Convert this variant to type Invalid and free up any resources used.</p> <h3 class="fn"><a name="convert" />bool QVariant.convert (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a> <i>t</i>)</h3><p>Casts the variant to the requested type, <i>t</i>. If the cast cannot be done, the variant is cleared. Returns true if the current type of the variant was successfully cast; otherwise returns false.</p> <p><b>Warning:</b> For historical reasons, converting a null <a href="qvariant.html">QVariant</a> results in a null value of the desired type (e.g., an empty string for <a href="qstring.html">QString</a>) and a result of false.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#clear">clear</a>().</p> <h3 class="fn"><a name="data" />sip.voidptr QVariant.data (<i>self</i>)</h3><h3 class="fn"><a name="detach" />QVariant.detach (<i>self</i>)</h3><h3 class="fn"><a name="fromList" />QVariant QVariant.fromList (list-of-QVariant <i>list</i>)</h3><h3 class="fn"><a name="fromMap" />QVariant QVariant.fromMap (dict-of-QString-QVariant <i>map</i>)</h3><h3 class="fn"><a name="isDetached" />bool QVariant.isDetached (<i>self</i>)</h3><h3 class="fn"><a name="isNull" />bool QVariant.isNull (<i>self</i>)</h3><p>Returns true if this is a NULL variant, false otherwise.</p> <h3 class="fn"><a name="isValid" />bool QVariant.isValid (<i>self</i>)</h3><p>Returns true if the storage type of this variant is not <a href="qvariant.html#Type-enum">QVariant.Invalid</a>; otherwise returns false.</p> <h3 class="fn"><a name="load" />QVariant.load (<i>self</i>, <a href="qdatastream.html">QDataStream</a> <i>ds</i>)</h3><h3 class="fn"><a name="nameToType" /><a href="qtcore.html#Type-enum">Type</a> QVariant.nameToType (str <i>name</i>)</h3><p>Converts the string representation of the storage type given in <i>name</i>, to its enum representation.</p> <p>If the string representation cannot be converted to any enum representation, the variant is set to <tt>Invalid</tt>.</p> <h3 class="fn"><a name="save" />QVariant.save (<i>self</i>, <a href="qdatastream.html">QDataStream</a> <i>ds</i>)</h3><h3 class="fn"><a name="swap" />QVariant.swap (<i>self</i>, QVariant <i>other</i>)</h3><p>Swaps variant <i>other</i> with this variant. This operation is very fast and never fails.</p> <p>This function was introduced in Qt 4.8.</p> <h3 class="fn"><a name="toBitArray" /><a href="qbitarray.html">QBitArray</a> QVariant.toBitArray (<i>self</i>)</h3><p>Returns the variant as a <a href="qbitarray.html">QBitArray</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">BitArray</a>; otherwise returns an empty bit array.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toBool" />bool QVariant.toBool (<i>self</i>)</h3><p>Returns the variant as a bool if the variant has <a href="qvariant.html#type">type</a>() Bool.</p> <p>Returns true if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a> and the value is non-zero, or if the variant has type <a href="qvariant.html#Type-enum">String</a> or <a href="qvariant.html#Type-enum">ByteArray</a> and its lower-case content is not empty, "0" or "false"; otherwise returns false.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toByteArray" /><a href="qbytearray.html">QByteArray</a> QVariant.toByteArray (<i>self</i>)</h3><p>Returns the variant as a <a href="qbytearray.html">QByteArray</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">ByteArray</a> or <a href="qvariant.html#Type-enum">String</a> (converted using <a href="qstring.html#fromAscii">QString.fromAscii</a>()); otherwise returns an empty byte array.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toChar" />QChar QVariant.toChar (<i>self</i>)</h3><p>Returns the variant as a <a href="qchar.html">QChar</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Int</a>, or <a href="qvariant.html#Type-enum">UInt</a>; otherwise returns an invalid <a href="qchar.html">QChar</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toDate" /><a href="qdate.html">QDate</a> QVariant.toDate (<i>self</i>)</h3><p>Returns the variant as a <a href="qdate.html">QDate</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid date.</p> <p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid date will be returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format date.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toDateTime" /><a href="qdatetime.html">QDateTime</a> QVariant.toDateTime (<i>self</i>)</h3><p>Returns the variant as a <a href="qdatetime.html">QDateTime</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Date</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid date/time.</p> <p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid date/time will be returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format date/time.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toDouble" />(float, bool <i>ok</i>) QVariant.toDouble (<i>self</i>)</h3><p>Returns the variant as a double if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to a double; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toEasingCurve" /><a href="qeasingcurve.html">QEasingCurve</a> QVariant.toEasingCurve (<i>self</i>)</h3><p>Returns the variant as a <a href="qeasingcurve.html">QEasingCurve</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">EasingCurve</a>; otherwise returns a default easing curve.</p> <p>This function was introduced in Qt 4.7.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toFloat" />(float, bool <i>ok</i>) QVariant.toFloat (<i>self</i>)</h3><p>Returns the variant as a float if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to a double; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p>This function was introduced in Qt 4.6.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toHash" />dict-of-QString-QVariant QVariant.toHash (<i>self</i>)</h3><p>Returns the variant as a <a href="qhash.html">QHash</a><<a href="qstring.html">QString</a>, <a href="qvariant.html">QVariant</a>> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Hash</a>; otherwise returns an empty map.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toInt" />(int, bool <i>ok</i>) QVariant.toInt (<i>self</i>)</h3><p>Returns the variant as an int if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to an int; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p><b>Warning:</b> If the value is convertible to a <a href="qvariant.html#Type-enum">LongLong</a> but is too large to be represented in an int, the resulting arithmetic overflow will not be reflected in <i>ok</i>. A simple workaround is to use <a href="qstring.html#toInt">QString.toInt</a>(). Fixing this bug has been postponed to Qt 5 in order to avoid breaking existing code.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toLine" /><a href="qline.html">QLine</a> QVariant.toLine (<i>self</i>)</h3><p>Returns the variant as a <a href="qline.html">QLine</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Line</a>; otherwise returns an invalid <a href="qline.html">QLine</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toLineF" /><a href="qlinef.html">QLineF</a> QVariant.toLineF (<i>self</i>)</h3><p>Returns the variant as a <a href="qlinef.html">QLineF</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">LineF</a>; otherwise returns an invalid <a href="qlinef.html">QLineF</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toList" />list-of-QVariant QVariant.toList (<i>self</i>)</h3><p>Returns the variant as a <a href="qvariant.html#QVariantList-typedef">QVariantList</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">List</a> or <a href="qvariant.html#Type-enum">StringList</a>; otherwise returns an empty list.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toLocale" /><a href="qlocale.html">QLocale</a> QVariant.toLocale (<i>self</i>)</h3><p>Returns the variant as a <a href="qlocale.html">QLocale</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Locale</a>; otherwise returns an invalid <a href="qlocale.html">QLocale</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toLongLong" />(int, bool <i>ok</i>) QVariant.toLongLong (<i>self</i>)</h3><p>Returns the variant as a long long int if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><tt>ok</tt> is set to true if the value could be converted to an int; otherwise <tt>*</tt><tt>ok</tt> is set to false.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toMap" />dict-of-QString-QVariant QVariant.toMap (<i>self</i>)</h3><p>Returns the variant as a <a href="qmap.html">QMap</a><<a href="qstring.html">QString</a>, <a href="qvariant.html">QVariant</a>> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Map</a>; otherwise returns an empty map.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toPoint" /><a href="qpoint.html">QPoint</a> QVariant.toPoint (<i>self</i>)</h3><p>Returns the variant as a <a href="qpoint.html">QPoint</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Point</a> or <a href="qvariant.html#Type-enum">PointF</a>; otherwise returns a null <a href="qpoint.html">QPoint</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toPointF" /><a href="qpointf.html">QPointF</a> QVariant.toPointF (<i>self</i>)</h3><p>Returns the variant as a <a href="qpointf.html">QPointF</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Point</a> or <a href="qvariant.html#Type-enum">PointF</a>; otherwise returns a null <a href="qpointf.html">QPointF</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toPyObject" />object QVariant.toPyObject (<i>self</i>)</h3><h3 class="fn"><a name="toReal" />(float, bool <i>ok</i>) QVariant.toReal (<i>self</i>)</h3><p>Returns the variant as a qreal if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to a double; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p>This function was introduced in Qt 4.6.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toRect" /><a href="qrect.html">QRect</a> QVariant.toRect (<i>self</i>)</h3><p>Returns the variant as a <a href="qrect.html">QRect</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Rect</a>; otherwise returns an invalid <a href="qrect.html">QRect</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toRectF" /><a href="qrectf.html">QRectF</a> QVariant.toRectF (<i>self</i>)</h3><p>Returns the variant as a <a href="qrectf.html">QRectF</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Rect</a> or <a href="qvariant.html#Type-enum">RectF</a>; otherwise returns an invalid <a href="qrectf.html">QRectF</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toRegExp" /><a href="qregexp.html">QRegExp</a> QVariant.toRegExp (<i>self</i>)</h3><p>Returns the variant as a <a href="qregexp.html">QRegExp</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">RegExp</a>; otherwise returns an empty <a href="qregexp.html">QRegExp</a>.</p> <p>This function was introduced in Qt 4.1.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toSize" /><a href="qsize.html">QSize</a> QVariant.toSize (<i>self</i>)</h3><p>Returns the variant as a <a href="qsize.html">QSize</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Size</a>; otherwise returns an invalid <a href="qsize.html">QSize</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toSizeF" /><a href="qsizef.html">QSizeF</a> QVariant.toSizeF (<i>self</i>)</h3><p>Returns the variant as a <a href="qsizef.html">QSizeF</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">SizeF</a>; otherwise returns an invalid <a href="qsizef.html">QSizeF</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toString" />QString QVariant.toString (<i>self</i>)</h3><p>Returns the variant as a <a href="qstring.html">QString</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns an empty string.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toStringList" />QStringList QVariant.toStringList (<i>self</i>)</h3><p>Returns the variant as a <a href="qstringlist.html">QStringList</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">List</a> of a type that can be converted to <a href="qstring.html">QString</a>; otherwise returns an empty list.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toTime" /><a href="qtime.html">QTime</a> QVariant.toTime (<i>self</i>)</h3><p>Returns the variant as a <a href="qtime.html">QTime</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">DateTime</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid time.</p> <p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid time will be returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format time.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toUInt" />(int, bool <i>ok</i>) QVariant.toUInt (<i>self</i>)</h3><p>Returns the variant as an unsigned int if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to an unsigned int; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p><b>Warning:</b> If the value is convertible to a <a href="qvariant.html#Type-enum">ULongLong</a> but is too large to be represented in an unsigned int, the resulting arithmetic overflow will not be reflected in <i>ok</i>. A simple workaround is to use <a href="qstring.html#toUInt">QString.toUInt</a>(). Fixing this bug has been postponed to Qt 5 in order to avoid breaking existing code.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toULongLong" />(int, bool <i>ok</i>) QVariant.toULongLong (<i>self</i>)</h3><p>Returns the variant as as an unsigned long long int if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">ULongLong</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">UInt</a>; otherwise returns 0.</p> <p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if the value could be converted to an int; otherwise <tt>*</tt><i>ok</i> is set to false.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="toUrl" /><a href="qurl.html">QUrl</a> QVariant.toUrl (<i>self</i>)</h3><p>Returns the variant as a <a href="qurl.html">QUrl</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Url</a>; otherwise returns an invalid <a href="qurl.html">QUrl</a>.</p> <p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p> <h3 class="fn"><a name="type" /><a href="qtcore.html#Type-enum">Type</a> QVariant.type (<i>self</i>)</h3><p>Returns the storage type of the value stored in the variant. Although this function is declared as returning <a href="qvariant.html#Type-enum">QVariant.Type</a>, the return value should be interpreted as <a href="qmetatype.html#Type-enum">QMetaType.Type</a>. In particular, <a href="qvariant.html#Type-enum">QVariant.UserType</a> is returned here only if the value is equal or greater than <a href="qmetatype.html#Type-enum">QMetaType.User</a>.</p> <p>Note that return values in the ranges <a href="qvariant.html#Type-enum">QVariant.Char</a> through <a href="qvariant.html#Type-enum">QVariant.RegExp</a> and <a href="qvariant.html#Type-enum">QVariant.Font</a> through <a href="qvariant.html#Type-enum">QVariant.Transform</a> correspond to the values in the ranges <a href="qmetatype.html#Type-enum">QMetaType.QChar</a> through <a href="qmetatype.html#Type-enum">QMetaType.QRegExp</a> and <a href="qmetatype.html#Type-enum">QMetaType.QFont</a> through <a href="qmetatype.html#Type-enum">QMetaType.QQuaternion</a>.</p> <p>Pay particular attention when working with char and <a href="qchar.html">QChar</a> variants. Note that there is no <a href="qvariant.html">QVariant</a> constructor specifically for type char, but there is one for <a href="qchar.html">QChar</a>. For a variant of type <a href="qchar.html">QChar</a>, this function returns <a href="qvariant.html#Type-enum">QVariant.Char</a>, which is the same as <a href="qmetatype.html#Type-enum">QMetaType.QChar</a>, but for a variant of type <tt>char</tt>, this function returns <a href="qmetatype.html#Type-enum">QMetaType.Char</a>, which is <i>not</i> the same as <a href="qvariant.html#Type-enum">QVariant.Char</a>.</p> <p>Also note that the types <tt>void*</tt>, <tt>long</tt>, <tt>short</tt>, <tt>unsigned</tt> <tt>long</tt>, <tt>unsigned</tt> <tt>short</tt>, <tt>unsigned</tt> <tt>char</tt>, <tt>float</tt>, <tt>QObject*</tt>, and <tt>QWidget*</tt> are represented in <a href="qmetatype.html#Type-enum">QMetaType.Type</a> but not in <a href="qvariant.html#Type-enum">QVariant.Type</a>, and they can be returned by this function. However, they are considered to be user defined types when tested against <a href="qvariant.html#Type-enum">QVariant.Type</a>.</p> <p>To test whether an instance of <a href="qvariant.html">QVariant</a> contains a data type that is compatible with the data type you are interested in, use <a href="qvariant.html#canConvert">canConvert</a>().</p> <h3 class="fn"><a name="typeName" />str QVariant.typeName (<i>self</i>)</h3><p>Returns the name of the type stored in the variant. The returned strings describe the C++ datatype used to store the data: for example, "<a href="qfont.html">QFont</a>", "<a href="qstring.html">QString</a>", or "<a href="qvariant.html#QVariantList-typedef">QVariantList</a>". An Invalid variant returns 0.</p> <h3 class="fn"><a name="typeToName" />str QVariant.typeToName (<a href="qtcore.html#Type-enum">Type</a> <i>type</i>)</h3><p>Converts the enum representation of the storage type, <i>typ</i>, to its string representation.</p> <p>Returns a null pointer if the type is <a href="qvariant.html#Type-enum">QVariant.Invalid</a> or doesn't exist.</p> <h3 class="fn"><a name="userType" />int QVariant.userType (<i>self</i>)</h3><p>Returns the storage type of the value stored in the variant. For non-user types, this is the same as <a href="qvariant.html#type">type</a>().</p> <p><b>See also</b> <a href="qvariant.html#type">type</a>().</p> <h3 class="fn"><a name="__eq__" />bool QVariant.__eq__ (<i>self</i>, QVariant <i>v</i>)</h3><h3 class="fn"><a name="__ne__" />bool QVariant.__ne__ (<i>self</i>, QVariant <i>v</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>