<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- datastreamformat.qdoc -->
<title>Qt 4.8: Serializing Qt Data Types</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li>Serializing Qt Data Types</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<h1 class="title">Serializing Qt Data Types</h1>
<span class="subtitle"></span>
<!-- $$$datastreamformat.html-description -->
<div class="descr"> <a name="details"></a>
<p>The <a href="qdatastream.html">QDataStream</a> allows you to serialize some of the Qt data types. The table below lists the data types that <a href="qdatastream.html">QDataStream</a> can serialize and how they are represented. The format described below is <a href="qdatastream.html#setVersion">version 12</a>.</p>
<p>It is always best to cast integers to a Qt integer type, such as qint16 or quint32, when reading and writing. This ensures that you always know exactly what size integers you are reading and writing, no matter what the underlying platform and architecture the application happens to be running on.</p>
<table class="generic">
<tr valign="top" class="odd"><td >bool</td><td ><ul>
<li>boolean</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td >qint8</td><td ><ul>
<li>signed byte</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td >qint16</td><td ><ul>
<li>signed 16-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td >qint32</td><td ><ul>
<li>signed 32-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td >qint64</td><td ><ul>
<li>signed 64-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td >quint8</td><td ><ul>
<li>unsigned byte</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td >quint16</td><td ><ul>
<li>unsigned 16-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td >quint32</td><td ><ul>
<li>unsigned 32-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td >quint64</td><td ><ul>
<li>unsigned 64-bit integer</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><tt>float</tt></td><td ><ul>
<li>32-bit floating point number using the standard IEEE 754 format</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><tt>double</tt></td><td ><ul>
<li>64-bit floating point number using the standard IEEE 754 format</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><tt>const char *</tt></td><td ><ul>
<li>The string length (quint32)</li>
<li>The string bytes, excluding the terminating 0</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qbitarray.html">QBitArray</a></td><td ><ul>
<li>The array size (quint32)</li>
<li>The array bits, i.e. (size + 7)/8 bytes</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qbrush.html">QBrush</a></td><td ><ul>
<li>The brush style (quint8)</li>
<li>The brush color (<a href="qcolor.html">QColor</a>)</li>
<li>If style is CustomPattern, the brush pixmap (<a href="qpixmap.html">QPixmap</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qbytearray.html">QByteArray</a></td><td ><ul>
<li>If the byte array is null: 0xFFFFFFFF (quint32)</li>
<li>Otherwise: the array size (quint32) followed by the array bytes, i.e. size bytes</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qcolor.html">QColor</a></td><td ><ul>
<li>Color spec (qint8)</li>
<li>Alpha value (quint16)</li>
<li>Red value (quint16)</li>
<li>Green value (quint16)</li>
<li>Blue value (quint16)</li>
<li>Pad value (quint16)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qcursor.html">QCursor</a></td><td ><ul>
<li>Shape ID (qint16)</li>
<li>If shape is BitmapCursor: The bitmap (<a href="qpixmap.html">QPixmap</a>), mask (<a href="qpixmap.html">QPixmap</a>), and hot spot (<a href="qpoint.html">QPoint</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qdate.html">QDate</a></td><td ><ul>
<li>Julian day (quint32)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qdatetime.html">QDateTime</a></td><td ><ul>
<li>Date (<a href="qdate.html">QDate</a>)</li>
<li>Time (<a href="qtime.html">QTime</a>)</li>
<li>0 for <a href="qt.html#TimeSpec-enum">Qt::LocalTime</a>, 1 for <a href="qt.html#TimeSpec-enum">Qt::UTC</a> (quint8)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qeasingcurve.html">QEasingCurve</a></td><td ><ul>
<li>type (quint8)</li>
<li>func (quint64)</li>
<li>hasConfig (bool)</li>
<li>If hasConfig is true then these fields follow:</li>
<li>list</li>
<li>period (double)</li>
<li>amplitude (double)</li>
<li>overshoot (double)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qfont.html">QFont</a></td><td ><ul>
<li>The family (<a href="qstring.html">QString</a>)</li>
<li>The point size (qint16)</li>
<li>The style hint (quint8)</li>
<li>The char set (quint8)</li>
<li>The weight (quint8)</li>
<li>The font bits (quint8)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qhash.html">QHash</a><Key, T></td><td ><ul>
<li>The number of items (quint32)</li>
<li>For all items, the key (Key) and value (T)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qicon.html">QIcon</a></td><td ><ul>
<li>The number of pixmap entries (quint32)</li>
<li>For all pixmap entries:<ul>
<li>The pixmap (<a href="qpixmap.html">QPixmap</a>)</li>
<li>The file name (<a href="qstring.html">QString</a>)</li>
<li>The pixmap size (<a href="qsize.html">QSize</a>)</li>
<li>The <a href="qicon.html#Mode-enum">mode</a> (quint32)</li>
<li>The <a href="qicon.html#State-enum">state</a> (quint32)</li>
</ul>
</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qimage.html">QImage</a></td><td ><ul>
<li>If the image is null a "null image" marker is saved; otherwise the image is saved in PNG or BMP format (depending on the stream version). If you want control of the format, stream the image into a <a href="qbuffer.html">QBuffer</a> (using <a href="porting4.html#qimageio">QImageIO</a>) and stream that.</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qkeysequence.html">QKeySequence</a></td><td ><ul>
<li>A <a href="qlist.html">QList</a><int>, where each integer is a key in the key sequence</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qlinkedlist.html">QLinkedList</a><T></td><td ><ul>
<li>The number of items (quint32)</li>
<li>The items (T)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qlist.html">QList</a><T></td><td ><ul>
<li>The number of items (quint32)</li>
<li>The items (T)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qmap.html">QMap</a><Key, T></td><td ><ul>
<li>The number of items (quint32)</li>
<li>For all items, the key (Key) and value (T)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qmatrix.html" class="obsolete">QMatrix<sup>(obsolete)</sup></a></td><td ><ul>
<li>m11 (double)</li>
<li>m12 (double)</li>
<li>m21 (double)</li>
<li>m22 (double)</li>
<li>dx (double)</li>
<li>dy (double)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qmatrix4x4.html">QMatrix4x4</a></td><td ><ul>
<li>m11 (double)</li>
<li>m12 (double)</li>
<li>m13 (double)</li>
<li>m14 (double)</li>
<li>m21 (double)</li>
<li>m22 (double)</li>
<li>m23 (double)</li>
<li>m24 (double)</li>
<li>m31 (double)</li>
<li>m32 (double)</li>
<li>m33 (double)</li>
<li>m34 (double)</li>
<li>m41 (double)</li>
<li>m42 (double)</li>
<li>m43 (double)</li>
<li>m44 (double)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qpair.html">QPair</a><T1, T2></td><td ><ul>
<li>first (T1)</li>
<li>second (T2)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qpalette.html">QPalette</a></td><td >The disabled, active, and inactive color groups, each of which consists of the following:<ul>
<li>foreground (<a href="qbrush.html">QBrush</a>)</li>
<li>button (<a href="qbrush.html">QBrush</a>)</li>
<li>light (<a href="qbrush.html">QBrush</a>)</li>
<li>midlight (<a href="qbrush.html">QBrush</a>)</li>
<li>dark (<a href="qbrush.html">QBrush</a>)</li>
<li>mid (<a href="qbrush.html">QBrush</a>)</li>
<li>text (<a href="qbrush.html">QBrush</a>)</li>
<li>brightText (<a href="qbrush.html">QBrush</a>)</li>
<li>buttonText (<a href="qbrush.html">QBrush</a>)</li>
<li>base (<a href="qbrush.html">QBrush</a>)</li>
<li>background (<a href="qbrush.html">QBrush</a>)</li>
<li>shadow (<a href="qbrush.html">QBrush</a>)</li>
<li>highlight (<a href="qbrush.html">QBrush</a>)</li>
<li>highlightedText (<a href="qbrush.html">QBrush</a>)</li>
<li>link (<a href="qbrush.html">QBrush</a>)</li>
<li>linkVisited (<a href="qbrush.html">QBrush</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qpen.html">QPen</a></td><td ><ul>
<li>The pen styles (quint8)</li>
<li>The pen width (quint16)</li>
<li>The pen color (<a href="qcolor.html">QColor</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qpicture.html">QPicture</a></td><td ><ul>
<li>The size of the picture data (quint32)</li>
<li>The raw bytes of picture data (char)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qpixmap.html">QPixmap</a></td><td ><ul>
<li>Save it as a PNG image.</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qpoint.html">QPoint</a></td><td ><ul>
<li>The x coordinate (qint32)</li>
<li>The y coordinate (qint32)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qquaternion.html">QQuaternion</a></td><td ><ul>
<li>The scalar component (double)</li>
<li>The x coordinate (double)</li>
<li>The y coordinate (double)</li>
<li>The z coordinate (double)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qrect.html">QRect</a></td><td ><ul>
<li>left (qint32)</li>
<li>top (qint32)</li>
<li>right (qint32)</li>
<li>bottom (qint32)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qregexp.html">QRegExp</a></td><td ><ul>
<li>The regexp pattern (<a href="qstring.html">QString</a>)</li>
<li>Case sensitivity (quint8)</li>
<li>Regular expression syntax (quint8)</li>
<li>Minimal matching (quint8)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qregion.html">QRegion</a></td><td ><ul>
<li>The size of the data, i.e. 8 + 16 * (number of rectangles) (quint32)</li>
<li>10 (qint32)</li>
<li>The number of rectangles (quint32)</li>
<li>The rectangles in sequential order (<a href="qrect.html">QRect</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qsize.html">QSize</a></td><td ><ul>
<li>width (qint32)</li>
<li>height (qint32)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qstring.html">QString</a></td><td ><ul>
<li>If the string is null: 0xFFFFFFFF (quint32)</li>
<li>Otherwise: The string length in bytes (quint32) followed by the data in UTF-16</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qtime.html">QTime</a></td><td ><ul>
<li>Milliseconds since midnight (quint32)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qtransform.html">QTransform</a></td><td ><ul>
<li>m11 (double)</li>
<li>m12 (double)</li>
<li>m13 (double)</li>
<li>m21 (double)</li>
<li>m22 (double)</li>
<li>m23 (double)</li>
<li>m31 (double)</li>
<li>m32 (double)</li>
<li>m33 (double)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qurl.html">QUrl</a></td><td ><ul>
<li>Holds an URL (<a href="qstring.html">QString</a>)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qvariant.html">QVariant</a></td><td ><ul>
<li>The type of the data (quint32)</li>
<li>The null flag (qint8)</li>
<li>The data of the specified type</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qvector2d.html">QVector2D</a></td><td ><ul>
<li>the x coordinate (double)</li>
<li>the y coordinate (double)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qvector3d.html">QVector3D</a></td><td ><ul>
<li>the x coordinate (double)</li>
<li>the y coordinate (double)</li>
<li>the z coordinate (double)</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td ><a href="qvector4d.html">QVector4D</a></td><td ><ul>
<li>the x coordinate (double)</li>
<li>the y coordinate (double)</li>
<li>the z coordinate (double)</li>
<li>the w coordinate (double)</li>
</ul>
</td></tr>
<tr valign="top" class="even"><td ><a href="qvector.html">QVector</a><T></td><td ><ul>
<li>The number of items (quint32)</li>
<li>The items (T)</li>
</ul>
</td></tr>
</table>
</div>
<!-- @@@datastreamformat.html -->
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
