Current File : //usr/share/doc/dbus/api/dbus-asv-util_8c_source.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>D-Bus: dbus-asv-util.c Source File</title>

<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />



</head>
<body>
<div id="top"><!-- do not remove this div! -->


<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">D-Bus
   &#160;<span id="projectnumber">1.8.20</span>
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.7.6.1 -->
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<div class="title">dbus-asv-util.c</div>  </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* dbus-asv-util.c - utility functions for a{sv}</span>
<a name="l00002"></a>00002 <span class="comment"> *</span>
<a name="l00003"></a>00003 <span class="comment"> * Copyright © 2011-2012 Nokia Corporation</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright © 2012-2013 Collabora Ltd.</span>
<a name="l00005"></a>00005 <span class="comment"> *</span>
<a name="l00006"></a>00006 <span class="comment"> * Licensed under the Academic Free License version 2.1</span>
<a name="l00007"></a>00007 <span class="comment"> *</span>
<a name="l00008"></a>00008 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00009"></a>00009 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00010"></a>00010 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00011"></a>00011 <span class="comment"> * (at your option) any later version.</span>
<a name="l00012"></a>00012 <span class="comment"> *</span>
<a name="l00013"></a>00013 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00014"></a>00014 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00015"></a>00015 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
<a name="l00016"></a>00016 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00017"></a>00017 <span class="comment"> *</span>
<a name="l00018"></a>00018 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00019"></a>00019 <span class="comment"> * along with this program; if not, write to the Free Software</span>
<a name="l00020"></a>00020 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA</span>
<a name="l00021"></a>00021 <span class="comment"> * 02110-1301 USA</span>
<a name="l00022"></a>00022 <span class="comment"> */</span>
<a name="l00023"></a>00023 
<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;config.h&gt;</span>
<a name="l00025"></a>00025 
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;dbus/dbus.h&gt;</span>
<a name="l00027"></a>00027 
<a name="l00028"></a>00028 <span class="preprocessor">#include &quot;dbus/dbus-asv-util.h&quot;</span>
<a name="l00029"></a>00029 
<a name="l00045"></a>00045 <a class="code" href="structDBusMessage.html" title="Internals of DBusMessage.">DBusMessage</a> *
<a name="l00046"></a>00046 _dbus_asv_new_method_return (<a class="code" href="structDBusMessage.html" title="Internals of DBusMessage.">DBusMessage</a>      *message,
<a name="l00047"></a>00047                              <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a>  *iter,
<a name="l00048"></a>00048                              <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a>  *arr_iter)
<a name="l00049"></a>00049 {
<a name="l00050"></a>00050   <a class="code" href="structDBusMessage.html" title="Internals of DBusMessage.">DBusMessage</a> *reply = <a class="code" href="group__DBusMessage.html#ga95142bd8288f397194ee0eefb1d27125" title="Constructs a message that is a reply to a method call.">dbus_message_new_method_return</a> (message);
<a name="l00051"></a>00051 
<a name="l00052"></a>00052   <span class="keywordflow">if</span> (reply == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00053"></a>00053     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00054"></a>00054 
<a name="l00055"></a>00055   <a class="code" href="group__DBusMessage.html#gaf733047c467ce21f4a53b65a388f1e9d" title="Initializes a DBusMessageIter for appending arguments to the end of a message.">dbus_message_iter_init_append</a> (reply, iter);
<a name="l00056"></a>00056 
<a name="l00057"></a>00057   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga943150f4e87fd8507da224d22c266100" title="Appends a container-typed value to the message; you are required to append the contents of the contai...">dbus_message_iter_open_container</a> (iter, <a class="code" href="group__DBusProtocol.html#ga8912f600f81a773066ca03d9163613a9" title="Type code marking a D-Bus array type.">DBUS_TYPE_ARRAY</a>, <span class="stringliteral">&quot;{sv}&quot;</span>,
<a name="l00058"></a>00058                                          arr_iter))
<a name="l00059"></a>00059     {
<a name="l00060"></a>00060       <a class="code" href="group__DBusMessage.html#gab69441efe683918f6a82469c8763f464" title="Decrements the reference count of a DBusMessage, freeing the message if the count reaches 0...">dbus_message_unref</a> (reply);
<a name="l00061"></a>00061       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00062"></a>00062     }
<a name="l00063"></a>00063 
<a name="l00064"></a>00064   <span class="keywordflow">return</span> reply;
<a name="l00065"></a>00065 }
<a name="l00066"></a>00066 
<a name="l00067"></a>00067 <span class="comment">/*</span>
<a name="l00068"></a>00068 <span class="comment"> * Open a new entry in an a{sv} (map from string to variant).</span>
<a name="l00069"></a>00069 <span class="comment"> *</span>
<a name="l00070"></a>00070 <span class="comment"> * This must be paired with a call to either _dbus_asv_close_entry()</span>
<a name="l00071"></a>00071 <span class="comment"> * or _dbus_asv_abandon_entry().</span>
<a name="l00072"></a>00072 <span class="comment"> *</span>
<a name="l00073"></a>00073 <span class="comment"> * If this function fails, the a{sv} must be abandoned, for instance</span>
<a name="l00074"></a>00074 <span class="comment"> * with _dbus_asv_abandon().</span>
<a name="l00075"></a>00075 <span class="comment"> *</span>
<a name="l00076"></a>00076 <span class="comment"> * @param arr_iter the iterator which is appending to the array</span>
<a name="l00077"></a>00077 <span class="comment"> * @param entry_iter will be initialized to append to the dict-entry</span>
<a name="l00078"></a>00078 <span class="comment"> * @param key a UTF-8 key for the map</span>
<a name="l00079"></a>00079 <span class="comment"> * @param type the type of the variant value, e.g. DBUS_TYPE_STRING_AS_STRING</span>
<a name="l00080"></a>00080 <span class="comment"> * @param var_iter will be initialized to append (i.e. write) to the variant</span>
<a name="l00081"></a>00081 <span class="comment"> * @returns #TRUE on success, or #FALSE if not enough memory</span>
<a name="l00082"></a>00082 <span class="comment"> */</span>
<a name="l00083"></a>00083 <span class="keyword">static</span> <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00084"></a>00084 _dbus_asv_open_entry (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter,
<a name="l00085"></a>00085                       <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *entry_iter,
<a name="l00086"></a>00086                       <span class="keyword">const</span> <span class="keywordtype">char</span>      *key,
<a name="l00087"></a>00087                       <span class="keyword">const</span> <span class="keywordtype">char</span>      *type,
<a name="l00088"></a>00088                       <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *var_iter)
<a name="l00089"></a>00089 {
<a name="l00090"></a>00090   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga943150f4e87fd8507da224d22c266100" title="Appends a container-typed value to the message; you are required to append the contents of the contai...">dbus_message_iter_open_container</a> (arr_iter, <a class="code" href="group__DBusProtocol.html#gad2fc8e6c50e0ad927f4249fb9e53ca97" title="Type code used to represent a dict entry; however, this type code does not appear in type signatures...">DBUS_TYPE_DICT_ENTRY</a>,
<a name="l00091"></a>00091                                          <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>, entry_iter))
<a name="l00092"></a>00092     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00093"></a>00093 
<a name="l00094"></a>00094   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga17491f3b75b3203f6fc47dcc2e3b221b" title="Appends a basic-typed value to the message.">dbus_message_iter_append_basic</a> (entry_iter, <a class="code" href="group__DBusProtocol.html#ga7eb77066dadf5415896b44c56d93acce" title="Type code marking a UTF-8 encoded, nul-terminated Unicode string.">DBUS_TYPE_STRING</a>, &amp;key))
<a name="l00095"></a>00095     {
<a name="l00096"></a>00096       <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (arr_iter, entry_iter);
<a name="l00097"></a>00097       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00098"></a>00098     }
<a name="l00099"></a>00099 
<a name="l00100"></a>00100   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga943150f4e87fd8507da224d22c266100" title="Appends a container-typed value to the message; you are required to append the contents of the contai...">dbus_message_iter_open_container</a> (entry_iter, <a class="code" href="group__DBusProtocol.html#ga4aa7a463ad2bce4e9aa95e3e397ddcf1" title="Type code marking a D-Bus variant type.">DBUS_TYPE_VARIANT</a>,
<a name="l00101"></a>00101                                          type, var_iter))
<a name="l00102"></a>00102     {
<a name="l00103"></a>00103       <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (arr_iter, entry_iter);
<a name="l00104"></a>00104       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00105"></a>00105     }
<a name="l00106"></a>00106 
<a name="l00107"></a>00107   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00108"></a>00108 }
<a name="l00109"></a>00109 
<a name="l00110"></a>00110 <span class="comment">/*</span>
<a name="l00111"></a>00111 <span class="comment"> * Closes an a{sv} entry after successfully appending the value.</span>
<a name="l00112"></a>00112 <span class="comment"> *</span>
<a name="l00113"></a>00113 <span class="comment"> * If this function fails, the a{sv} must be abandoned, for instance</span>
<a name="l00114"></a>00114 <span class="comment"> * with _dbus_asv_abandon().</span>
<a name="l00115"></a>00115 <span class="comment"> *</span>
<a name="l00116"></a>00116 <span class="comment"> * @param arr_iter the iterator which is appending to the array</span>
<a name="l00117"></a>00117 <span class="comment"> * @param entry_iter the iterator appending to the dict-entry, will be closed</span>
<a name="l00118"></a>00118 <span class="comment"> * @param var_iter the iterator appending to the variant, will be closed</span>
<a name="l00119"></a>00119 <span class="comment"> * @returns #TRUE on success, or #FALSE if not enough memory</span>
<a name="l00120"></a>00120 <span class="comment"> */</span>
<a name="l00121"></a>00121 <span class="keyword">static</span> <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00122"></a>00122 _dbus_asv_close_entry (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter,
<a name="l00123"></a>00123                        <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *entry_iter,
<a name="l00124"></a>00124                        <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *var_iter)
<a name="l00125"></a>00125 {
<a name="l00126"></a>00126   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#gaf00482f63d4af88b7851621d1f24087a" title="Closes a container-typed value appended to the message; may write out more information to the message...">dbus_message_iter_close_container</a> (entry_iter, var_iter))
<a name="l00127"></a>00127     {
<a name="l00128"></a>00128       <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (arr_iter, entry_iter);
<a name="l00129"></a>00129       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00130"></a>00130     }
<a name="l00131"></a>00131 
<a name="l00132"></a>00132   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#gaf00482f63d4af88b7851621d1f24087a" title="Closes a container-typed value appended to the message; may write out more information to the message...">dbus_message_iter_close_container</a> (arr_iter, entry_iter))
<a name="l00133"></a>00133     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00134"></a>00134 
<a name="l00135"></a>00135   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00136"></a>00136 }
<a name="l00137"></a>00137 
<a name="l00148"></a>00148 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00149"></a>00149 _dbus_asv_close (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *iter,
<a name="l00150"></a>00150                  <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter)
<a name="l00151"></a>00151 {
<a name="l00152"></a>00152   <span class="keywordflow">return</span> <a class="code" href="group__DBusMessage.html#gaf00482f63d4af88b7851621d1f24087a" title="Closes a container-typed value appended to the message; may write out more information to the message...">dbus_message_iter_close_container</a> (iter, arr_iter);
<a name="l00153"></a>00153 }
<a name="l00154"></a>00154 
<a name="l00155"></a>00155 <span class="comment">/*</span>
<a name="l00156"></a>00156 <span class="comment"> * Closes an a{sv} entry after unsuccessfully appending a value.</span>
<a name="l00157"></a>00157 <span class="comment"> * You must also abandon the a{sv} itself (for instance with</span>
<a name="l00158"></a>00158 <span class="comment"> * _dbus_asv_abandon()), and abandon whatever larger data structure</span>
<a name="l00159"></a>00159 <span class="comment"> * the a{sv} was embedded in.</span>
<a name="l00160"></a>00160 <span class="comment"> *</span>
<a name="l00161"></a>00161 <span class="comment"> * @param iter the iterator which is appending to the message or other data structure containing the a{sv}</span>
<a name="l00162"></a>00162 <span class="comment"> * @param arr_iter the iterator appending to the array, will be closed</span>
<a name="l00163"></a>00163 <span class="comment"> * @returns #TRUE on success, or #FALSE if not enough memory</span>
<a name="l00164"></a>00164 <span class="comment"> */</span>
<a name="l00165"></a>00165 <span class="keyword">static</span> <span class="keywordtype">void</span>
<a name="l00166"></a>00166 _dbus_asv_abandon_entry (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter,
<a name="l00167"></a>00167                          <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *entry_iter,
<a name="l00168"></a>00168                          <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *var_iter)
<a name="l00169"></a>00169 {
<a name="l00170"></a>00170   <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (entry_iter, var_iter);
<a name="l00171"></a>00171   <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (arr_iter, entry_iter);
<a name="l00172"></a>00172 }
<a name="l00173"></a>00173 
<a name="l00183"></a>00183 <span class="keywordtype">void</span>
<a name="l00184"></a>00184 _dbus_asv_abandon (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *iter,
<a name="l00185"></a>00185                    <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter)
<a name="l00186"></a>00186 {
<a name="l00187"></a>00187   <a class="code" href="group__DBusMessage.html#ga6e62697ca11f0a57dbecc93d5721612c" title="Abandons creation of a contained-typed value and frees resources created by dbus_message_iter_open_co...">dbus_message_iter_abandon_container</a> (iter, arr_iter);
<a name="l00188"></a>00188 }
<a name="l00189"></a>00189 
<a name="l00202"></a>00202 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00203"></a>00203 _dbus_asv_add_uint32 (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter,
<a name="l00204"></a>00204                       <span class="keyword">const</span> <span class="keywordtype">char</span> *key,
<a name="l00205"></a>00205                       <a class="code" href="group__DBusTypes.html#gaf513803b030613a669cc7ef199f90a8b" title="A 32-bit unsigned integer on all platforms.">dbus_uint32_t</a> value)
<a name="l00206"></a>00206 {
<a name="l00207"></a>00207   <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> entry_iter, var_iter;
<a name="l00208"></a>00208 
<a name="l00209"></a>00209   <span class="keywordflow">if</span> (!_dbus_asv_open_entry (arr_iter, &amp;entry_iter, key,
<a name="l00210"></a>00210                              <a class="code" href="group__DBusProtocol.html#gadd89012acfc88aef2b084ed265242e5e" title="DBUS_TYPE_UINT32 as a string literal instead of a int literal">DBUS_TYPE_UINT32_AS_STRING</a>, &amp;var_iter))
<a name="l00211"></a>00211     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00212"></a>00212 
<a name="l00213"></a>00213   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga17491f3b75b3203f6fc47dcc2e3b221b" title="Appends a basic-typed value to the message.">dbus_message_iter_append_basic</a> (&amp;var_iter, <a class="code" href="group__DBusProtocol.html#gaedb1740bd8a9174b98ac593eded25d49" title="Type code marking a 32-bit unsigned integer.">DBUS_TYPE_UINT32</a>,
<a name="l00214"></a>00214                                        &amp;value))
<a name="l00215"></a>00215     {
<a name="l00216"></a>00216       _dbus_asv_abandon_entry (arr_iter, &amp;entry_iter, &amp;var_iter);
<a name="l00217"></a>00217       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00218"></a>00218     }
<a name="l00219"></a>00219 
<a name="l00220"></a>00220   <span class="keywordflow">if</span> (!_dbus_asv_close_entry (arr_iter, &amp;entry_iter, &amp;var_iter))
<a name="l00221"></a>00221     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00222"></a>00222 
<a name="l00223"></a>00223   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00224"></a>00224 }
<a name="l00225"></a>00225 
<a name="l00238"></a>00238 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00239"></a>00239 _dbus_asv_add_string (<a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> *arr_iter,
<a name="l00240"></a>00240                       <span class="keyword">const</span> <span class="keywordtype">char</span> *key,
<a name="l00241"></a>00241                       <span class="keyword">const</span> <span class="keywordtype">char</span> *value)
<a name="l00242"></a>00242 {
<a name="l00243"></a>00243   <a class="code" href="structDBusMessageIter.html" title="DBusMessageIter struct; contains no public fields.">DBusMessageIter</a> entry_iter, var_iter;
<a name="l00244"></a>00244 
<a name="l00245"></a>00245   <span class="keywordflow">if</span> (!_dbus_asv_open_entry (arr_iter, &amp;entry_iter, key,
<a name="l00246"></a>00246                              <a class="code" href="group__DBusProtocol.html#gabca06d9d52c249619f52c903c06800aa" title="DBUS_TYPE_STRING as a string literal instead of a int literal">DBUS_TYPE_STRING_AS_STRING</a>, &amp;var_iter))
<a name="l00247"></a>00247     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00248"></a>00248 
<a name="l00249"></a>00249   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusMessage.html#ga17491f3b75b3203f6fc47dcc2e3b221b" title="Appends a basic-typed value to the message.">dbus_message_iter_append_basic</a> (&amp;var_iter, <a class="code" href="group__DBusProtocol.html#ga7eb77066dadf5415896b44c56d93acce" title="Type code marking a UTF-8 encoded, nul-terminated Unicode string.">DBUS_TYPE_STRING</a>,
<a name="l00250"></a>00250                                        &amp;value))
<a name="l00251"></a>00251     {
<a name="l00252"></a>00252       _dbus_asv_abandon_entry (arr_iter, &amp;entry_iter, &amp;var_iter);
<a name="l00253"></a>00253       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00254"></a>00254     }
<a name="l00255"></a>00255 
<a name="l00256"></a>00256   <span class="keywordflow">if</span> (!_dbus_asv_close_entry (arr_iter, &amp;entry_iter, &amp;var_iter))
<a name="l00257"></a>00257     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00258"></a>00258 
<a name="l00259"></a>00259   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00260"></a>00260 }
</pre></div></div><!-- contents -->


<hr class="footer"/><address class="footer"><small>
Generated on Thu Mar 3 2016 17:50:29 for D-Bus by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.6.1
</small></address>

</body>
</html>