<?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" />
<!-- qdbusargument.cpp -->
<title>Qt 4.8: QDBusArgument Class Reference</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><a href="modules.html">Modules</a></li>
<li><a href="qtdbus.html">QtDBus</a></li>
<li>QDBusArgument</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">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#related-non-members">Related Non-Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QDBusArgument Class Reference</h1>
<!-- $$$QDBusArgument-brief -->
<p>The QDBusArgument class is used to marshall and demarshall D-Bus arguments. <a href="#details">More...</a></p>
<!-- @@@QDBusArgument -->
<pre class="cpp"> <span class="preprocessor">#include <QDBusArgument></span></pre><p>This class was introduced in Qt 4.2.</p>
<ul>
<li><a href="qdbusargument-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#ElementType-enum">ElementType</a></b> { BasicType, VariantType, ArrayType, StructureType, ..., UnknownType }</td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#QDBusArgument">QDBusArgument</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#QDBusArgument-2">QDBusArgument</a></b> ( const QDBusArgument & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#dtor.QDBusArgument">~QDBusArgument</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#asVariant">asVariant</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#atEnd">atEnd</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginArray">beginArray</a></b> ( int <i>id</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginArray-2">beginArray</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginMap">beginMap</a></b> ( int <i>kid</i>, int <i>vid</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginMap-2">beginMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginMapEntry">beginMapEntry</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginMapEntry-2">beginMapEntry</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginStructure">beginStructure</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#beginStructure-2">beginStructure</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> ElementType </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#currentType">currentType</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endArray">endArray</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endArray-2">endArray</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endMap">endMap</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endMap-2">endMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endMapEntry">endMapEntry</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endMapEntry-2">endMapEntry</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endStructure">endStructure</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#endStructure-2">endStructure</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt">operator<<</a></b> ( uchar <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-2">operator<<</a></b> ( bool <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-3">operator<<</a></b> ( short <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-4">operator<<</a></b> ( ushort <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-5">operator<<</a></b> ( int <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-6">operator<<</a></b> ( uint <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-7">operator<<</a></b> ( qlonglong <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-8">operator<<</a></b> ( qulonglong <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-9">operator<<</a></b> ( double <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-10">operator<<</a></b> ( const QString & <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-14">operator<<</a></b> ( const QDBusVariant & <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-15">operator<<</a></b> ( const QStringList & <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-lt-lt-16">operator<<</a></b> ( const QByteArray & <i>arg</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-eq">operator=</a></b> ( const QDBusArgument & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt">operator>></a></b> ( uchar & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-2">operator>></a></b> ( bool & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-3">operator>></a></b> ( ushort & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-4">operator>></a></b> ( short & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-5">operator>></a></b> ( int & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-6">operator>></a></b> ( uint & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-7">operator>></a></b> ( qlonglong & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-8">operator>></a></b> ( qulonglong & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-9">operator>></a></b> ( double & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-10">operator>></a></b> ( QString & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-14">operator>></a></b> ( QDBusVariant & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-15">operator>></a></b> ( QStringList & <i>arg</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QDBusArgument & </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#operator-gt-gt-16">operator>></a></b> ( QByteArray & <i>arg</i> ) const</td></tr>
</table>
<a name="related-non-members"></a>
<h2>Related Non-Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#qDBusRegisterMetaType">qDBusRegisterMetaType</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> T </td><td class="memItemRight bottomAlign"><b><a href="qdbusargument.html#qdbus_cast">qdbus_cast</a></b> ( const QDBusArgument & <i>argument</i> )</td></tr>
</table>
<a name="details"></a>
<!-- $$$QDBusArgument-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QDBusArgument class is used to marshall and demarshall D-Bus arguments.</p>
<p>The class is used to send arguments over D-Bus to remote applications and to receive them back. D-Bus offers an extensible type system, based on a few primitive types and associations of them. See the <a href="qdbustypesystem.html">QtDBus type system</a> page for more information on the type system.</p>
<p>QDBusArgument is the central class in the <a href="qtdbus.html">QtDBus</a> type system, providing functions to marshall and demarshall the primitive types. The compound types are then created by association of one or more of the primitive types in arrays, dictionaries or structures.</p>
<p>The following example illustrates how a structure containing an integer and a string can be constructed using the <a href="qdbustypesystem.html">QtDBus type system</a>:</p>
<pre class="cpp"> <span class="keyword">struct</span> MyStructure
{
<span class="type">int</span> count;
<span class="type"><a href="qstring.html">QString</a></span> name;
};
<a href="qmetatype.html#Q_DECLARE_METATYPE">Q_DECLARE_METATYPE</a>(MyStructure)
<span class="comment">// Marshall the MyStructure data into a D-Bus argument</span>
<span class="type">QDBusArgument</span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator"><</span><span class="operator"><</span>(<span class="type">QDBusArgument</span> <span class="operator">&</span>argument<span class="operator">,</span> <span class="keyword">const</span> MyStructure <span class="operator">&</span>mystruct)
{
argument<span class="operator">.</span>beginStructure();
argument <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>count <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>name;
argument<span class="operator">.</span>endStructure();
<span class="keyword">return</span> argument;
}
<span class="comment">// Retrieve the MyStructure data from the D-Bus argument</span>
<span class="keyword">const</span> <span class="type">QDBusArgument</span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator">></span><span class="operator">></span>(<span class="keyword">const</span> <span class="type">QDBusArgument</span> <span class="operator">&</span>argument<span class="operator">,</span> MyStructure <span class="operator">&</span>mystruct)
{
argument<span class="operator">.</span>beginStructure();
argument <span class="operator">></span><span class="operator">></span> mystruct<span class="operator">.</span>count <span class="operator">></span><span class="operator">></span> mystruct<span class="operator">.</span>name;
argument<span class="operator">.</span>endStructure();
<span class="keyword">return</span> argument;
}</pre>
<p>The type has to be registered with <a href="qdbusargument.html#qDBusRegisterMetaType">qDBusRegisterMetaType</a>() before it can be used with QDBusArgument. Therefore, somewhere in your program, you should add the following code:</p>
<pre class="cpp"> qDBusRegisterMetaType<span class="operator"><</span>MyStructure<span class="operator">></span>();</pre>
<p>Once registered, a type can be used in outgoing method calls (placed with <a href="qdbusabstractinterface.html#call">QDBusAbstractInterface::call</a>()), signal emissions from registered objects or in incoming calls from remote applications.</p>
<p>It is important to note that the <tt>operator<<</tt> and <tt>operator>></tt> streaming functions must always produce the same number of entries in case of structures, both in reading and in writing (marshalling and demarshalling), otherwise calls and signals may start to silently fail.</p>
<p>The following example illustrates this wrong usage in context of a class that may contain invalid data:</p>
<pre class="cpp"> // Wrongly marshall the MyTime data into a D-Bus argument
QDBusArgument &operator<<(QDBusArgument &argument, const MyTime &mytime)
{
argument.beginStructure();
if (mytime.isValid)
argument << true << mytime.hour
<< mytime.minute << mytime.second;
else
argument << false;
argument.endStructure();
return argument;
}</pre>
<p>In this example, both the <tt>operator<<</tt> and the <tt>operator>></tt> functions may produce a different number of reads/writes. This can confuse the <a href="qtdbus.html">QtDBus</a> type system and should be avoided.</p>
</div>
<p><b>See also </b><a href="qdbusabstractinterface.html">QDBusAbstractInterface</a>, <a href="qdbustypesystem.html">The QtDBus type system</a>, <a href="usingadaptors.html">Using Adaptors</a>, and <a href="qdbusargument.html#qdbus_cast">qdbus_cast</a>().</p>
<!-- @@@QDBusArgument -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$ElementType$$$BasicType$$$VariantType$$$ArrayType$$$StructureType$$$MapType$$$MapEntryType$$$UnknownType -->
<h3 class="fn"><a name="ElementType-enum"></a>enum QDBusArgument::<span class="name">ElementType</span></h3>
<p>This enum describes the type of element held by the argument.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QDBusArgument::BasicType</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">A basic element, which is understood by <a href="qvariant.html">QVariant</a>. The following types are considered basic: bool, byte, short, ushort, int, uint, qint64, quint64, double, <a href="qstring.html">QString</a>, <a href="qbytearray.html">QByteArray</a>, <a href="qdbusobjectpath.html">QDBusObjectPath</a>, <a href="qdbussignature.html">QDBusSignature</a></td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::VariantType</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The variant element (<a href="qdbusvariant.html">QDBusVariant</a>)</td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::ArrayType</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">An array element, usually represented by <a href="qlist.html">QList</a><T> or <a href="qvector.html">QVector</a><T>. Note: <a href="qbytearray.html">QByteArray</a> and associative maps are not considered arrays, even if the D-Bus protocol transports them as such.</td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::StructureType</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">A custom type represented by a structure, like <a href="qdatetime.html">QDateTime</a>, <a href="qpoint.html">QPoint</a>, etc.</td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::MapType</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">An associative container, like <a href="qmap.html">QMap</a><Key, Value> or <a href="qhash.html">QHash</a><Key, Value></td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::MapEntryType</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">One entry in an associative container: both the key and the value form one map-entry type.</td></tr>
<tr><td class="topAlign"><tt>QDBusArgument::UnknownType</tt></td><td class="topAlign"><tt>-1</tt></td><td class="topAlign">The type is unknown or we have reached the end of the list.</td></tr>
</table>
<p>This enum was introduced or modified in Qt 4.5.</p>
<p><b>See also </b><a href="qdbusargument.html#currentType">currentType</a>().</p>
<!-- @@@ElementType -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QDBusArgument[overload1]$$$QDBusArgument -->
<h3 class="fn"><a name="QDBusArgument"></a>QDBusArgument::<span class="name">QDBusArgument</span> ()</h3>
<p>Constructs an empty <a href="qdbusargument.html">QDBusArgument</a> argument.</p>
<p>An empty <a href="qdbusargument.html">QDBusArgument</a> object does not allow either reading or writing to be performed.</p>
<!-- @@@QDBusArgument -->
<!-- $$$QDBusArgument$$$QDBusArgumentconstQDBusArgument& -->
<h3 class="fn"><a name="QDBusArgument-2"></a>QDBusArgument::<span class="name">QDBusArgument</span> ( const <span class="type">QDBusArgument</span> & <i>other</i> )</h3>
<p>Constructs a copy of the <i>other</i> <a href="qdbusargument.html">QDBusArgument</a> object.</p>
<p>Both objects will therefore contain the same state from this point forward. QDBusArguments are explicitly shared and, therefore, any modification to either copy will affect the other one too.</p>
<!-- @@@QDBusArgument -->
<!-- $$$~QDBusArgument[overload1]$$$~QDBusArgument -->
<h3 class="fn"><a name="dtor.QDBusArgument"></a>QDBusArgument::<span class="name">~QDBusArgument</span> ()</h3>
<p>Disposes of the resources associated with this <a href="qdbusargument.html">QDBusArgument</a> object.</p>
<!-- @@@~QDBusArgument -->
<!-- $$$asVariant[overload1]$$$asVariant -->
<h3 class="fn"><a name="asVariant"></a><span class="type"><a href="qvariant.html">QVariant</a></span> QDBusArgument::<span class="name">asVariant</span> () const</h3>
<p>Returns the current argument in the form of a <a href="qvariant.html">QVariant</a>. Basic types will be decoded and returned in the <a href="qvariant.html">QVariant</a>, but for complex types, this function will return a <a href="qdbusargument.html">QDBusArgument</a> object in the <a href="qvariant.html">QVariant</a>. It is the caller's responsibility to decode the argument (for example, by calling asVariant() in it).</p>
<p>For example, if the current argument is an INT32, this function will return a <a href="qvariant.html">QVariant</a> with an argument of type <a href="qvariant.html#Type-enum">QVariant::Int</a>. For an array of INT32, it will return a <a href="qvariant.html">QVariant</a> containing a <a href="qdbusargument.html">QDBusArgument</a>.</p>
<p>If an error occurs or if there are no more arguments to decode (i.e., we are at the end of the argument list), this function will return an invalid <a href="qvariant.html">QVariant</a>.</p>
<p>This function was introduced in Qt 4.5.</p>
<p><b>See also </b><a href="qdbusargument.html#atEnd">atEnd</a>().</p>
<!-- @@@asVariant -->
<!-- $$$atEnd[overload1]$$$atEnd -->
<h3 class="fn"><a name="atEnd"></a><span class="type">bool</span> QDBusArgument::<span class="name">atEnd</span> () const</h3>
<p>Returns true if there are no more elements to be extracted from this <a href="qdbusargument.html">QDBusArgument</a>. This function is usually used in <a href="qdbusargument.html">QDBusArgument</a> objects returned from <a href="qdbusargument.html#beginMap">beginMap</a>() and <a href="qdbusargument.html#beginArray">beginArray</a>().</p>
<!-- @@@atEnd -->
<!-- $$$beginArray[overload1]$$$beginArrayint -->
<h3 class="fn"><a name="beginArray"></a><span class="type">void</span> QDBusArgument::<span class="name">beginArray</span> ( <span class="type">int</span> <i>id</i> )</h3>
<p>Opens a new D-Bus array suitable for appending elements of meta-type <i>id</i>.</p>
<p>This function is used usually in <tt>operator<<</tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="comment">// append an array of MyElement types</span>
<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator"><</span><span class="operator"><</span>(<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> <span class="keyword">const</span> MyArray <span class="operator">&</span>myarray)
{
argument<span class="operator">.</span>beginArray( <a href="qmetatype.html#qMetaTypeId">qMetaTypeId</a><span class="operator"><</span>MyElement<span class="operator">></span>() );
<span class="keyword">for</span> ( <span class="type">int</span> i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator"><</span> myarray<span class="operator">.</span>length; <span class="operator">+</span><span class="operator">+</span>i )
argument <span class="operator"><</span><span class="operator"><</span> myarray<span class="operator">.</span>elements<span class="operator">[</span>i<span class="operator">]</span>;
argument<span class="operator">.</span>endArray();
<span class="keyword">return</span> argument;
}</pre>
<p>If the type you want to marshall is a <a href="qlist.html">QList</a>, <a href="qvector.html">QVector</a> or any of the Qt's <a href="containers.html">Container Classes</a> that take one template parameter, you need not declare an <tt>operator<<</tt> function for it, since <a href="qtdbus.html">QtDBus</a> provides generic templates to do the job of marshalling the data. The same applies for STL's sequence containers, such as <tt>std::list</tt>, <tt>std::vector</tt>, etc.</p>
<p><b>See also </b><a href="qdbusargument.html#endArray">endArray</a>(), <a href="qdbusargument.html#beginStructure">beginStructure</a>(), and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginArray -->
<!-- $$$beginArray$$$beginArray -->
<h3 class="fn"><a name="beginArray-2"></a><span class="type">void</span> QDBusArgument::<span class="name">beginArray</span> () const</h3>
<p>Recurses into the D-Bus array to allow extraction of the array elements.</p>
<p>This function is used usually in <tt>operator>></tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="comment">// extract a MyArray array of MyElement elements</span>
<span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator">></span><span class="operator">></span>(<span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> MyArray <span class="operator">&</span>myarray)
{
argument<span class="operator">.</span>beginArray();
myarray<span class="operator">.</span>clear();
<span class="keyword">while</span> ( <span class="operator">!</span>argument<span class="operator">.</span>atEnd() ) {
MyElement element;
argument <span class="operator">></span><span class="operator">></span> element;
myarray<span class="operator">.</span>append( element );
}
argument<span class="operator">.</span>endArray();
<span class="keyword">return</span> argument;
}</pre>
<p>If the type you want to demarshall is a <a href="qlist.html">QList</a>, <a href="qvector.html">QVector</a> or any of the Qt's <a href="containers.html">Container Classes</a> that take one template parameter, you need not declare an <tt>operator>></tt> function for it, since <a href="qtdbus.html">QtDBus</a> provides generic templates to do the job of demarshalling the data. The same applies for STL's sequence containers, such as <tt>std::list</tt>, <tt>std::vector</tt>, etc.</p>
<p><b>See also </b><a href="qdbusargument.html#atEnd">atEnd</a>(), <a href="qdbusargument.html#beginStructure">beginStructure</a>(), and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginArray -->
<!-- $$$beginMap[overload1]$$$beginMapintint -->
<h3 class="fn"><a name="beginMap"></a><span class="type">void</span> QDBusArgument::<span class="name">beginMap</span> ( <span class="type">int</span> <i>kid</i>, <span class="type">int</span> <i>vid</i> )</h3>
<p>Opens a new D-Bus map suitable for appending elements. Maps are containers that associate one entry (the key) to another (the value), such as Qt's <a href="qmap.html">QMap</a> or <a href="qhash.html">QHash</a>. The ids of the map's key and value meta types must be passed in <i>kid</i> and <i>vid</i> respectively.</p>
<p>This function is used usually in <tt>operator<<</tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="comment">// append a dictionary that associates ints to MyValue types</span>
<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator"><</span><span class="operator"><</span>(<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> <span class="keyword">const</span> MyDictionary <span class="operator">&</span>mydict)
{
argument<span class="operator">.</span>beginMap( <span class="type"><a href="qvariant.html">QVariant</a></span><span class="operator">::</span>Int<span class="operator">,</span> <a href="qmetatype.html#qMetaTypeId">qMetaTypeId</a><span class="operator"><</span>MyValue<span class="operator">></span>() );
<span class="keyword">for</span> ( <span class="type">int</span> i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator"><</span> mydict<span class="operator">.</span>length; <span class="operator">+</span><span class="operator">+</span>i ) {
argument<span class="operator">.</span>beginMapEntry();
argument <span class="operator"><</span><span class="operator"><</span> mydict<span class="operator">.</span>data<span class="operator">[</span>i<span class="operator">]</span><span class="operator">.</span>key <span class="operator"><</span><span class="operator"><</span> mydict<span class="operator">.</span>data<span class="operator">[</span>i<span class="operator">]</span><span class="operator">.</span>value;
argument<span class="operator">.</span>endMapEntry();
}
argument<span class="operator">.</span>endMap();
<span class="keyword">return</span> argument;
}</pre>
<p>If the type you want to marshall is a <a href="qmap.html">QMap</a> or <a href="qhash.html">QHash</a>, you need not declare an <tt>operator<<</tt> function for it, since <a href="qtdbus.html">QtDBus</a> provides generic templates to do the job of marshalling the data.</p>
<p><b>See also </b><a href="qdbusargument.html#endMap">endMap</a>(), <a href="qdbusargument.html#beginStructure">beginStructure</a>(), <a href="qdbusargument.html#beginArray">beginArray</a>(), and <a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>().</p>
<!-- @@@beginMap -->
<!-- $$$beginMap$$$beginMap -->
<h3 class="fn"><a name="beginMap-2"></a><span class="type">void</span> QDBusArgument::<span class="name">beginMap</span> () const</h3>
<p>Recurses into the D-Bus map to allow extraction of the map's elements.</p>
<p>This function is used usually in <tt>operator>></tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="comment">// extract a MyDictionary map that associates ints to MyValue elements</span>
<span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator">></span><span class="operator">></span>(<span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> MyDictionary <span class="operator">&</span>mydict)
{
argument<span class="operator">.</span>beginMap();
mydict<span class="operator">.</span>clear();
<span class="keyword">while</span> ( <span class="operator">!</span>argMap<span class="operator">.</span>atEnd() ) {
<span class="type">int</span> key;
MyValue value;
argument<span class="operator">.</span>beginMapEntry();
argument <span class="operator">></span><span class="operator">></span> key <span class="operator">></span><span class="operator">></span> value;
argument<span class="operator">.</span>endMapEntry();
mydict<span class="operator">.</span>append( key<span class="operator">,</span> value );
}
argument<span class="operator">.</span>endMap();
<span class="keyword">return</span> argument;
}</pre>
<p>If the type you want to demarshall is a <a href="qmap.html">QMap</a> or <a href="qhash.html">QHash</a>, you need not declare an <tt>operator>></tt> function for it, since <a href="qtdbus.html">QtDBus</a> provides generic templates to do the job of demarshalling the data.</p>
<p><b>See also </b><a href="qdbusargument.html#endMap">endMap</a>(), <a href="qdbusargument.html#beginStructure">beginStructure</a>(), <a href="qdbusargument.html#beginArray">beginArray</a>(), and <a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>().</p>
<!-- @@@beginMap -->
<!-- $$$beginMapEntry[overload1]$$$beginMapEntry -->
<h3 class="fn"><a name="beginMapEntry"></a><span class="type">void</span> QDBusArgument::<span class="name">beginMapEntry</span> ()</h3>
<p>Opens a D-Bus map entry suitable for appending the key and value entries. This function is only valid when a map has been opened with <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<p>See <a href="qdbusargument.html#beginMap">beginMap</a>() for an example of usage of this function.</p>
<p><b>See also </b><a href="qdbusargument.html#endMapEntry">endMapEntry</a>() and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginMapEntry -->
<!-- $$$beginMapEntry$$$beginMapEntry -->
<h3 class="fn"><a name="beginMapEntry-2"></a><span class="type">void</span> QDBusArgument::<span class="name">beginMapEntry</span> () const</h3>
<p>Recurses into the D-Bus map entry to allow extraction of the key and value pair.</p>
<p>See <a href="qdbusargument.html#beginMap">beginMap</a>() for an example of how this function is usually used.</p>
<p><b>See also </b><a href="qdbusargument.html#endMapEntry">endMapEntry</a>() and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginMapEntry -->
<!-- $$$beginStructure[overload1]$$$beginStructure -->
<h3 class="fn"><a name="beginStructure"></a><span class="type">void</span> QDBusArgument::<span class="name">beginStructure</span> ()</h3>
<p>Opens a new D-Bus structure suitable for appending new arguments.</p>
<p>This function is used usually in <tt>operator<<</tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator"><</span><span class="operator"><</span>(<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> <span class="keyword">const</span> MyStructure <span class="operator">&</span>mystruct)
{
argument<span class="operator">.</span>beginStructure();
argument <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member1 <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member2 <span class="operator"><</span><span class="operator"><</span> <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> ;
argument<span class="operator">.</span>endStructure();
<span class="keyword">return</span> argument;
}</pre>
<p>Structures can contain other structures, so the following code is also valid:</p>
<pre class="cpp"> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator"><</span><span class="operator"><</span>(<span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> <span class="keyword">const</span> MyStructure <span class="operator">&</span>mystruct)
{
argument<span class="operator">.</span>beginStructure();
argument <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member1 <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member2;
argument<span class="operator">.</span>beginStructure();
argument <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member3<span class="operator">.</span>subMember1 <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member3<span class="operator">.</span>subMember2;
argument<span class="operator">.</span>endStructure();
argument <span class="operator"><</span><span class="operator"><</span> mystruct<span class="operator">.</span>member4;
argument<span class="operator">.</span>endStructure();
<span class="keyword">return</span> argument;
}</pre>
<p><b>See also </b><a href="qdbusargument.html#endStructure">endStructure</a>(), <a href="qdbusargument.html#beginArray">beginArray</a>(), and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginStructure -->
<!-- $$$beginStructure$$$beginStructure -->
<h3 class="fn"><a name="beginStructure-2"></a><span class="type">void</span> QDBusArgument::<span class="name">beginStructure</span> () const</h3>
<p>Opens a D-Bus structure suitable for extracting elements.</p>
<p>This function is used usually in <tt>operator>></tt> streaming operators, as in the following example:</p>
<pre class="cpp"> <span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span><span class="keyword">operator</span><span class="operator">></span><span class="operator">></span>(<span class="keyword">const</span> <span class="type"><a href="qdbusargument.html">QDBusArgument</a></span> <span class="operator">&</span>argument<span class="operator">,</span> MyStructure <span class="operator">&</span>mystruct)
{
argument<span class="operator">.</span>beginStructure()
argument <span class="operator">></span><span class="operator">></span> mystruct<span class="operator">.</span>member1 <span class="operator">></span><span class="operator">></span> mystruct<span class="operator">.</span>member2 <span class="operator">></span><span class="operator">></span> mystruct<span class="operator">.</span>member3 <span class="operator">></span><span class="operator">></span> <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>;
argument<span class="operator">.</span>endStructure();
<span class="keyword">return</span> argument;
}</pre>
<p><b>See also </b><a href="qdbusargument.html#endStructure">endStructure</a>(), <a href="qdbusargument.html#beginArray">beginArray</a>(), and <a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@beginStructure -->
<!-- $$$currentType[overload1]$$$currentType -->
<h3 class="fn"><a name="currentType"></a><span class="type"><a href="qdbusargument.html#ElementType-enum">ElementType</a></span> QDBusArgument::<span class="name">currentType</span> () const</h3>
<p>Returns the classification of the current element type. If an error decoding the type occurs or if we're at the end of the argument, this function returns <a href="qdbusargument.html#ElementType-enum">QDBusArgument::UnknownType</a>.</p>
<p>This function only makes sense when demarshalling arguments. If it is used while marshalling, it will always return <a href="qdbusargument.html#ElementType-enum">UnknownType</a>.</p>
<p>This function was introduced in Qt 4.5.</p>
<!-- @@@currentType -->
<!-- $$$endArray[overload1]$$$endArray -->
<h3 class="fn"><a name="endArray"></a><span class="type">void</span> QDBusArgument::<span class="name">endArray</span> ()</h3>
<p>Closes a D-Bus array opened with <a href="qdbusargument.html#beginArray">beginArray</a>(). This function must be called same number of times that <a href="qdbusargument.html#beginArray">beginArray</a>() is called.</p>
<p><b>See also </b><a href="qdbusargument.html#beginArray">beginArray</a>(), <a href="qdbusargument.html#endStructure">endStructure</a>(), and <a href="qdbusargument.html#endMap">endMap</a>().</p>
<!-- @@@endArray -->
<!-- $$$endArray$$$endArray -->
<h3 class="fn"><a name="endArray-2"></a><span class="type">void</span> QDBusArgument::<span class="name">endArray</span> () const</h3>
<p>Closes the D-Bus array and allow extracting of the next element after the array.</p>
<p><b>See also </b><a href="qdbusargument.html#beginArray">beginArray</a>().</p>
<!-- @@@endArray -->
<!-- $$$endMap[overload1]$$$endMap -->
<h3 class="fn"><a name="endMap"></a><span class="type">void</span> QDBusArgument::<span class="name">endMap</span> ()</h3>
<p>Closes a D-Bus map opened with <a href="qdbusargument.html#beginMap">beginMap</a>(). This function must be called same number of times that <a href="qdbusargument.html#beginMap">beginMap</a>() is called.</p>
<p><b>See also </b><a href="qdbusargument.html#beginMap">beginMap</a>(), <a href="qdbusargument.html#endStructure">endStructure</a>(), and <a href="qdbusargument.html#endArray">endArray</a>().</p>
<!-- @@@endMap -->
<!-- $$$endMap$$$endMap -->
<h3 class="fn"><a name="endMap-2"></a><span class="type">void</span> QDBusArgument::<span class="name">endMap</span> () const</h3>
<p>Closes the D-Bus map and allow extracting of the next element after the map.</p>
<p><b>See also </b><a href="qdbusargument.html#beginMap">beginMap</a>().</p>
<!-- @@@endMap -->
<!-- $$$endMapEntry[overload1]$$$endMapEntry -->
<h3 class="fn"><a name="endMapEntry"></a><span class="type">void</span> QDBusArgument::<span class="name">endMapEntry</span> ()</h3>
<p>Closes a D-Bus map entry opened with <a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>(). This function must be called same number of times that <a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>() is called.</p>
<p><b>See also </b><a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>().</p>
<!-- @@@endMapEntry -->
<!-- $$$endMapEntry$$$endMapEntry -->
<h3 class="fn"><a name="endMapEntry-2"></a><span class="type">void</span> QDBusArgument::<span class="name">endMapEntry</span> () const</h3>
<p>Closes the D-Bus map entry and allow extracting of the next element on the map.</p>
<p><b>See also </b><a href="qdbusargument.html#beginMapEntry">beginMapEntry</a>().</p>
<!-- @@@endMapEntry -->
<!-- $$$endStructure[overload1]$$$endStructure -->
<h3 class="fn"><a name="endStructure"></a><span class="type">void</span> QDBusArgument::<span class="name">endStructure</span> ()</h3>
<p>Closes a D-Bus structure opened with <a href="qdbusargument.html#beginStructure">beginStructure</a>(). This function must be called same number of times that <a href="qdbusargument.html#beginStructure">beginStructure</a>() is called.</p>
<p><b>See also </b><a href="qdbusargument.html#beginStructure">beginStructure</a>(), <a href="qdbusargument.html#endArray">endArray</a>(), and <a href="qdbusargument.html#endMap">endMap</a>().</p>
<!-- @@@endStructure -->
<!-- $$$endStructure$$$endStructure -->
<h3 class="fn"><a name="endStructure-2"></a><span class="type">void</span> QDBusArgument::<span class="name">endStructure</span> () const</h3>
<p>Closes the D-Bus structure and allow extracting of the next element after the structure.</p>
<p><b>See also </b><a href="qdbusargument.html#beginStructure">beginStructure</a>().</p>
<!-- @@@endStructure -->
<!-- $$$operator<<[overload1]$$$operator<<uchar -->
<h3 class="fn"><a name="operator-lt-lt"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type"><a href="qtglobal.html#uchar-typedef">uchar</a></span> <i>arg</i> )</h3>
<p>Appends the primitive value <i>arg</i> of type <tt>BYTE</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<bool -->
<h3 class="fn"><a name="operator-lt-lt-2"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type">bool</span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>BOOLEAN</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<short -->
<h3 class="fn"><a name="operator-lt-lt-3"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type">short</span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>INT16</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<ushort -->
<h3 class="fn"><a name="operator-lt-lt-4"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type"><a href="qtglobal.html#ushort-typedef">ushort</a></span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>UINT16</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<int -->
<h3 class="fn"><a name="operator-lt-lt-5"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type">int</span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>INT32</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<uint -->
<h3 class="fn"><a name="operator-lt-lt-6"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type"><a href="qtglobal.html#uint-typedef">uint</a></span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>UINT32</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<qlonglong -->
<h3 class="fn"><a name="operator-lt-lt-7"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type"><a href="qtglobal.html#qlonglong-typedef">qlonglong</a></span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>INT64</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<qulonglong -->
<h3 class="fn"><a name="operator-lt-lt-8"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type"><a href="qtglobal.html#qulonglong-typedef">qulonglong</a></span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>UINT64</tt> to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<double -->
<h3 class="fn"><a name="operator-lt-lt-9"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( <span class="type">double</span> <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>DOUBLE</tt> (double-precision floating-point) to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<constQString& -->
<h3 class="fn"><a name="operator-lt-lt-10"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>STRING</tt> (Unicode character string) to the D-Bus stream.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<constQDBusVariant& -->
<h3 class="fn"><a name="operator-lt-lt-14"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( const <span class="type"><a href="qdbusvariant.html">QDBusVariant</a></span> & <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the primitive value <i>arg</i> of type <tt>VARIANT</tt> to the D-Bus stream.</p>
<p>A D-Bus variant type can contain any type, including other variants. It is similar to the Qt <a href="qvariant.html">QVariant</a> type.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<constQStringList& -->
<h3 class="fn"><a name="operator-lt-lt-15"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( const <span class="type"><a href="qstringlist.html">QStringList</a></span> & <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the <a href="qstringlist.html">QStringList</a> given by <i>arg</i> as <tt>ARRAY of STRING</tt> to the D-Bus stream.</p>
<p><a href="qstringlist.html">QStringList</a> and <a href="qbytearray.html">QByteArray</a> are the only two non-primitive types that are supported directly by <a href="qdbusargument.html">QDBusArgument</a> because of their widespread usage in Qt applications.</p>
<p>Other arrays are supported through compound types in <a href="qtdbus.html">QtDBus</a>.</p>
<!-- @@@operator<< -->
<!-- $$$operator<<$$$operator<<constQByteArray& -->
<h3 class="fn"><a name="operator-lt-lt-16"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator<<</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>arg</i> )</h3>
<p>This is an overloaded function.</p>
<p>Appends the <a href="qbytearray.html">QByteArray</a> given by <i>arg</i> as <tt>ARRAY of BYTE</tt> to the D-Bus stream.</p>
<p><a href="qstringlist.html">QStringList</a> and <a href="qbytearray.html">QByteArray</a> are the only two non-primitive types that are supported directly by <a href="qdbusargument.html">QDBusArgument</a> because of their widespread usage in Qt applications.</p>
<p>Other arrays are supported through compound types in <a href="qtdbus.html">QtDBus</a>.</p>
<!-- @@@operator<< -->
<!-- $$$operator=[overload1]$$$operator=constQDBusArgument& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator=</span> ( const <span class="type">QDBusArgument</span> & <i>other</i> )</h3>
<p>Copies the <i>other</i> <a href="qdbusargument.html">QDBusArgument</a> object into this one.</p>
<p>Both objects will therefore contain the same state from this point forward. QDBusArguments are explicitly shared and, therefore, any modification to either copy will affect the other one too.</p>
<!-- @@@operator= -->
<!-- $$$operator>>[overload1]$$$operator>>uchar& -->
<h3 class="fn"><a name="operator-gt-gt"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qtglobal.html#uchar-typedef">uchar</a></span> & <i>arg</i> ) const</h3>
<p>Extracts one D-BUS primitive argument of type <tt>BYTE</tt> from the D-BUS stream and puts it into <i>arg</i>.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>bool& -->
<h3 class="fn"><a name="operator-gt-gt-2"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type">bool</span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>BOOLEAN</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>ushort& -->
<h3 class="fn"><a name="operator-gt-gt-3"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qtglobal.html#ushort-typedef">ushort</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>UINT16</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>short& -->
<h3 class="fn"><a name="operator-gt-gt-4"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type">short</span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>INT16</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>int& -->
<h3 class="fn"><a name="operator-gt-gt-5"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type">int</span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>INT32</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>uint& -->
<h3 class="fn"><a name="operator-gt-gt-6"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qtglobal.html#uint-typedef">uint</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>UINT32</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>qlonglong& -->
<h3 class="fn"><a name="operator-gt-gt-7"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qtglobal.html#qlonglong-typedef">qlonglong</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>INT64</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>qulonglong& -->
<h3 class="fn"><a name="operator-gt-gt-8"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qtglobal.html#qulonglong-typedef">qulonglong</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>UINT64</tt> from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>double& -->
<h3 class="fn"><a name="operator-gt-gt-9"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type">double</span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>DOUBLE</tt> (double-precision floating pount) from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>QString& -->
<h3 class="fn"><a name="operator-gt-gt-10"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qstring.html">QString</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>STRING</tt> (Unicode character string) from the D-Bus stream.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>QDBusVariant& -->
<h3 class="fn"><a name="operator-gt-gt-14"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qdbusvariant.html">QDBusVariant</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts one D-Bus primitive argument of type <tt>VARIANT</tt> from the D-Bus stream.</p>
<p>A D-Bus variant type can contain any type, including other variants. It is similar to the Qt <a href="qvariant.html">QVariant</a> type.</p>
<p>In case the variant contains a type not directly supported by <a href="qdbusargument.html">QDBusArgument</a>, the value of the returned <a href="qdbusvariant.html">QDBusVariant</a> will contain another <a href="qdbusargument.html">QDBusArgument</a>. It is your responsibility to further demarshall it into another type.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>QStringList& -->
<h3 class="fn"><a name="operator-gt-gt-15"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qstringlist.html">QStringList</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts an array of strings from the D-Bus stream and return it as a <a href="qstringlist.html">QStringList</a>.</p>
<p><a href="qstringlist.html">QStringList</a> and <a href="qbytearray.html">QByteArray</a> are the only two non-primitive types that are supported directly by <a href="qdbusargument.html">QDBusArgument</a> because of their widespread usage in Qt applications.</p>
<p>Other arrays are supported through compound types in <a href="qtdbus.html">QtDBus</a>.</p>
<!-- @@@operator>> -->
<!-- $$$operator>>$$$operator>>QByteArray& -->
<h3 class="fn"><a name="operator-gt-gt-16"></a>const <span class="type">QDBusArgument</span> & QDBusArgument::<span class="name">operator>></span> ( <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>arg</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Extracts an array of bytes from the D-Bus stream and return it as a <a href="qbytearray.html">QByteArray</a>.</p>
<p><a href="qstringlist.html">QStringList</a> and <a href="qbytearray.html">QByteArray</a> are the only two non-primitive types that are supported directly by <a href="qdbusargument.html">QDBusArgument</a> because of their widespread usage in Qt applications.</p>
<p>Other arrays are supported through compound types in <a href="qtdbus.html">QtDBus</a>.</p>
<!-- @@@operator>> -->
</div>
<div class="relnonmem">
<h2>Related Non-Members</h2>
<!-- $$$qDBusRegisterMetaType[overload1]$$$qDBusRegisterMetaType -->
<h3 class="fn"><a name="qDBusRegisterMetaType"></a><span class="type">int</span> <span class="name">qDBusRegisterMetaType</span> ()</h3>
<p>Registers <tt>T</tt> with the <a href="qdbustypesystem.html">QtDBus type system</a> and the Qt <a href="qmetatype.html">meta-type system</a>, if it's not already registered.</p>
<p>To register a type, it must be declared as a meta-type with the <a href="qmetatype.html#Q_DECLARE_METATYPE">Q_DECLARE_METATYPE</a>() macro, and then registered as in the following example:</p>
<pre class="cpp"> <span class="preprocessor">#include <QDBusMetaType></span>
qDBusRegisterMetaType<span class="operator"><</span>MyClass<span class="operator">></span>();</pre>
<p>If <tt>T</tt> isn't a type derived from one of Qt's <a href="containers.html">container classes</a>, the <tt>operator<<</tt> and <tt>operator>></tt> streaming operators between <tt>T</tt> and <a href="qdbusargument.html">QDBusArgument</a> must be already declared. See the <a href="qdbustypesystem.html">QtDBus type system</a> page for more information on how to declare such types.</p>
<p>This function returns the Qt meta type id for the type (the same value that is returned from <a href="qmetatype.html#qRegisterMetaType">qRegisterMetaType</a>()).</p>
<p><b>Note:</b> This function is <a href="threads-reentrancy.html#thread-safe">thread-safe</a>.</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also </b><a href="qdbustypesystem.html">QtDBus type system</a>, <a href="qmetatype.html#qRegisterMetaType">qRegisterMetaType</a>(), and <a href="qmetatype.html">QMetaType</a>.</p>
<!-- @@@qDBusRegisterMetaType -->
<!-- $$$qdbus_cast[overload1]$$$qdbus_castconstQDBusArgument& -->
<h3 class="fn"><a name="qdbus_cast"></a><span class="type">T</span> <span class="name">qdbus_cast</span> ( const <span class="type">QDBusArgument</span> & <i>argument</i> )</h3>
<p>Attempts to demarshall the contents of <i>argument</i> into the type <tt>T</tt>. For example:</p>
<pre class="cpp"> MyType item <span class="operator">=</span> qdbus_cast<span class="operator"><</span>Type<span class="operator">></span>(argument);</pre>
<p>Note that it is equivalent to the following:</p>
<pre class="cpp"> MyType item;
argument <span class="operator">></span><span class="operator">></span> item;</pre>
<p>This function was introduced in Qt 4.2.</p>
<!-- @@@qdbus_cast -->
</div>
</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>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
1dd17e0d683ef79b4bb6872bbf359d7f
>
files
>
5031
