Current File : //usr/share/doc/dbus/api/dbus-address_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-address.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-address.c</div>  </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- mode: C; c-file-style: &quot;gnu&quot;; indent-tabs-mode: nil; -*- */</span>
<a name="l00002"></a>00002 <span class="comment">/* dbus-address.c  Server address parser.</span>
<a name="l00003"></a>00003 <span class="comment"> *</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 2003  CodeFactory AB</span>
<a name="l00005"></a>00005 <span class="comment"> * Copyright (C) 2004,2005  Red Hat, Inc.</span>
<a name="l00006"></a>00006 <span class="comment"> *</span>
<a name="l00007"></a>00007 <span class="comment"> * Licensed under the Academic Free License version 2.1</span>
<a name="l00008"></a>00008 <span class="comment"> * </span>
<a name="l00009"></a>00009 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00010"></a>00010 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00011"></a>00011 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00012"></a>00012 <span class="comment"> * (at your option) any later version.</span>
<a name="l00013"></a>00013 <span class="comment"> *</span>
<a name="l00014"></a>00014 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00015"></a>00015 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00016"></a>00016 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
<a name="l00017"></a>00017 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00018"></a>00018 <span class="comment"> * </span>
<a name="l00019"></a>00019 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00020"></a>00020 <span class="comment"> * along with this program; if not, write to the Free Software</span>
<a name="l00021"></a>00021 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA</span>
<a name="l00022"></a>00022 <span class="comment"> *</span>
<a name="l00023"></a>00023 <span class="comment"> */</span>
<a name="l00024"></a>00024 
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;config.h&gt;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &quot;dbus-address.h&quot;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &quot;dbus-internals.h&quot;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &quot;dbus-list.h&quot;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &quot;dbus-string.h&quot;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &quot;dbus-protocol.h&quot;</span>
<a name="l00031"></a>00031 
<a name="l00043"></a><a class="code" href="structDBusAddressEntry.html">00043</a> <span class="keyword">struct </span><a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a>
<a name="l00044"></a>00044 {
<a name="l00045"></a><a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f">00045</a>   <a class="code" href="structDBusString.html">DBusString</a> <a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f" title="The address type (unix, tcp, etc.)">method</a>; 
<a name="l00047"></a><a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846">00047</a>   <a class="code" href="structDBusList.html" title="A node in a linked list.">DBusList</a> *<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>;    
<a name="l00048"></a><a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8">00048</a>   <a class="code" href="structDBusList.html" title="A node in a linked list.">DBusList</a> *<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>;  
<a name="l00049"></a>00049 };
<a name="l00050"></a>00050 
<a name="l00051"></a>00051 
<a name="l00064"></a>00064 <span class="keywordtype">void</span>
<a name="l00065"></a><a class="code" href="group__DBusAddressInternals.html#ga5b6409826263c7d62570c56889f7ddb2">00065</a> <a class="code" href="group__DBusAddressInternals.html#ga5b6409826263c7d62570c56889f7ddb2" title="Sets DBUS_ERROR_BAD_ADDRESS.">_dbus_set_bad_address</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>  *error,
<a name="l00066"></a>00066                        <span class="keyword">const</span> <span class="keywordtype">char</span> *address_problem_type,
<a name="l00067"></a>00067                        <span class="keyword">const</span> <span class="keywordtype">char</span> *address_problem_field,
<a name="l00068"></a>00068                        <span class="keyword">const</span> <span class="keywordtype">char</span> *address_problem_other)
<a name="l00069"></a>00069 {
<a name="l00070"></a>00070   <span class="keywordflow">if</span> (address_problem_type != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00071"></a>00071     <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00072"></a>00072                     <span class="stringliteral">&quot;Server address of type %s was missing argument %s&quot;</span>,
<a name="l00073"></a>00073                     address_problem_type, address_problem_field);
<a name="l00074"></a>00074   <span class="keywordflow">else</span>
<a name="l00075"></a>00075     <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00076"></a>00076                     <span class="stringliteral">&quot;Could not parse server address: %s&quot;</span>,
<a name="l00077"></a>00077                     address_problem_other);
<a name="l00078"></a>00078 }
<a name="l00079"></a>00079 
<a name="l00084"></a><a class="code" href="group__DBusAddressInternals.html#ga0e46a8bc37d92810fe3d535019d3bad1">00084</a> <span class="preprocessor">#define _DBUS_ADDRESS_OPTIONALLY_ESCAPED_BYTE(b)        \</span>
<a name="l00085"></a>00085 <span class="preprocessor">         (((b) &gt;= &#39;a&#39; &amp;&amp; (b) &lt;= &#39;z&#39;) ||                 \</span>
<a name="l00086"></a>00086 <span class="preprocessor">          ((b) &gt;= &#39;A&#39; &amp;&amp; (b) &lt;= &#39;Z&#39;) ||                 \</span>
<a name="l00087"></a>00087 <span class="preprocessor">          ((b) &gt;= &#39;0&#39; &amp;&amp; (b) &lt;= &#39;9&#39;) ||                 \</span>
<a name="l00088"></a>00088 <span class="preprocessor">          (b) == &#39;-&#39; ||                                 \</span>
<a name="l00089"></a>00089 <span class="preprocessor">          (b) == &#39;_&#39; ||                                 \</span>
<a name="l00090"></a>00090 <span class="preprocessor">          (b) == &#39;/&#39; ||                                 \</span>
<a name="l00091"></a>00091 <span class="preprocessor">          (b) == &#39;\\&#39; ||                                \</span>
<a name="l00092"></a>00092 <span class="preprocessor">          (b) == &#39;*&#39; ||                                \</span>
<a name="l00093"></a>00093 <span class="preprocessor">          (b) == &#39;.&#39;)</span>
<a name="l00094"></a>00094 <span class="preprocessor"></span>
<a name="l00103"></a>00103 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00104"></a><a class="code" href="group__DBusAddressInternals.html#ga1ecc2f460303cd70c34e7667e8b12b37">00104</a> <a class="code" href="group__DBusAddressInternals.html#ga1ecc2f460303cd70c34e7667e8b12b37" title="Appends an escaped version of one string to another string, using the D-Bus address escaping mechanis...">_dbus_address_append_escaped</a> (<a class="code" href="structDBusString.html">DBusString</a>       *escaped,
<a name="l00105"></a>00105                               <span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *unescaped)
<a name="l00106"></a>00106 {
<a name="l00107"></a>00107   <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *p;
<a name="l00108"></a>00108   <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *end;
<a name="l00109"></a>00109   <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a> ret;
<a name="l00110"></a>00110   <span class="keywordtype">int</span> orig_len;
<a name="l00111"></a>00111 
<a name="l00112"></a>00112   ret = <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00113"></a>00113 
<a name="l00114"></a>00114   orig_len = <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (escaped);
<a name="l00115"></a>00115   p = (<span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *) <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (unescaped);
<a name="l00116"></a>00116   end = p + <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (unescaped);
<a name="l00117"></a>00117   <span class="keywordflow">while</span> (p != end)
<a name="l00118"></a>00118     {
<a name="l00119"></a>00119       <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddressInternals.html#ga0e46a8bc37d92810fe3d535019d3bad1" title="TRUE if the byte need not be escaped when found in a dbus address.">_DBUS_ADDRESS_OPTIONALLY_ESCAPED_BYTE</a> (*p))
<a name="l00120"></a>00120         {
<a name="l00121"></a>00121           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaa6ecf36e70263659f921a4ef0335db12" title="Appends a single byte to the string, returning FALSE if not enough memory.">_dbus_string_append_byte</a> (escaped, *p))
<a name="l00122"></a>00122             <span class="keywordflow">goto</span> out;
<a name="l00123"></a>00123         }
<a name="l00124"></a>00124       <span class="keywordflow">else</span>
<a name="l00125"></a>00125         {
<a name="l00126"></a>00126           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaa6ecf36e70263659f921a4ef0335db12" title="Appends a single byte to the string, returning FALSE if not enough memory.">_dbus_string_append_byte</a> (escaped, <span class="charliteral">&#39;%&#39;</span>))
<a name="l00127"></a>00127             <span class="keywordflow">goto</span> out;
<a name="l00128"></a>00128           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gae99a331d4e5b7758652b78dc9c89de84" title="Appends a two-character hex digit to a string, where the hex digit has the value of the given byte...">_dbus_string_append_byte_as_hex</a> (escaped, *p))
<a name="l00129"></a>00129             <span class="keywordflow">goto</span> out;
<a name="l00130"></a>00130         }
<a name="l00131"></a>00131       
<a name="l00132"></a>00132       ++p;
<a name="l00133"></a>00133     }
<a name="l00134"></a>00134 
<a name="l00135"></a>00135   ret = <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  out:
<a name="l00138"></a>00138   <span class="keywordflow">if</span> (!ret)
<a name="l00139"></a>00139     <a class="code" href="group__DBusString.html#ga08c423b93c28dd746dcb93e0461ab95c" title="Sets the length of a string.">_dbus_string_set_length</a> (escaped, orig_len);
<a name="l00140"></a>00140   <span class="keywordflow">return</span> ret;
<a name="l00141"></a>00141 }
<a name="l00142"></a>00142  <span class="comment">/* End of internals */</span>
<a name="l00144"></a>00144 
<a name="l00145"></a>00145 <span class="keyword">static</span> <span class="keywordtype">void</span>
<a name="l00146"></a>00146 dbus_address_entry_free (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *entry)
<a name="l00147"></a>00147 {
<a name="l00148"></a>00148   <a class="code" href="structDBusList.html" title="A node in a linked list.">DBusList</a> *link;
<a name="l00149"></a>00149   
<a name="l00150"></a>00150   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f" title="The address type (unix, tcp, etc.)">method</a>);
<a name="l00151"></a>00151 
<a name="l00152"></a>00152   link = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>);
<a name="l00153"></a>00153   <span class="keywordflow">while</span> (link != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00154"></a>00154     {
<a name="l00155"></a>00155       <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00156"></a>00156       <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00157"></a>00157       
<a name="l00158"></a>00158       link = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>, link);
<a name="l00159"></a>00159     }
<a name="l00160"></a>00160   <a class="code" href="group__DBusList.html#gaa36d13444a050a923941c53650b72f9d" title="Frees all links in the list and sets the list head to NULL.">_dbus_list_clear</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>);
<a name="l00161"></a>00161   
<a name="l00162"></a>00162   link = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>);
<a name="l00163"></a>00163   <span class="keywordflow">while</span> (link != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00164"></a>00164     {
<a name="l00165"></a>00165       <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00166"></a>00166       <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00167"></a>00167       
<a name="l00168"></a>00168       link = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>, link);
<a name="l00169"></a>00169     }
<a name="l00170"></a>00170   <a class="code" href="group__DBusList.html#gaa36d13444a050a923941c53650b72f9d" title="Frees all links in the list and sets the list head to NULL.">_dbus_list_clear</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>);
<a name="l00171"></a>00171   
<a name="l00172"></a>00172   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (entry);
<a name="l00173"></a>00173 }
<a name="l00174"></a>00174 
<a name="l00188"></a>00188 <span class="keywordtype">void</span>
<a name="l00189"></a><a class="code" href="group__DBusAddress.html#ga37a7009b07cf991ff07f3e86d71bf352">00189</a> <a class="code" href="group__DBusAddress.html#ga37a7009b07cf991ff07f3e86d71bf352" title="Frees a NULL-terminated array of address entries.">dbus_address_entries_free</a> (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> **entries)
<a name="l00190"></a>00190 {
<a name="l00191"></a>00191   <span class="keywordtype">int</span> i;
<a name="l00192"></a>00192   
<a name="l00193"></a>00193   <span class="keywordflow">for</span> (i = 0; entries[i] != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>; i++)
<a name="l00194"></a>00194     dbus_address_entry_free (entries[i]);
<a name="l00195"></a>00195   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (entries);
<a name="l00196"></a>00196 }
<a name="l00197"></a>00197 
<a name="l00198"></a>00198 <span class="keyword">static</span> <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *
<a name="l00199"></a>00199 create_entry (<span class="keywordtype">void</span>)
<a name="l00200"></a>00200 {
<a name="l00201"></a>00201   <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *entry;
<a name="l00202"></a>00202 
<a name="l00203"></a>00203   entry = <a class="code" href="group__DBusMemory.html#gaba9d823abda7f4cadbaf5177d3b8b793" title="Safe macro for using dbus_malloc0().">dbus_new0</a> (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a>, 1);
<a name="l00204"></a>00204 
<a name="l00205"></a>00205   <span class="keywordflow">if</span> (entry == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00206"></a>00206     <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="l00207"></a>00207 
<a name="l00208"></a>00208   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f" title="The address type (unix, tcp, etc.)">method</a>))
<a name="l00209"></a>00209     {
<a name="l00210"></a>00210       <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (entry);
<a name="l00211"></a>00211       <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="l00212"></a>00212     }
<a name="l00213"></a>00213 
<a name="l00214"></a>00214   <span class="keywordflow">return</span> entry;
<a name="l00215"></a>00215 }
<a name="l00216"></a>00216 
<a name="l00226"></a>00226 <span class="keyword">const</span> <span class="keywordtype">char</span> *
<a name="l00227"></a><a class="code" href="group__DBusAddress.html#ga7e6b2572d6e637826acada01377b5487">00227</a> <a class="code" href="group__DBusAddress.html#ga7e6b2572d6e637826acada01377b5487" title="Returns the method string of an address entry.">dbus_address_entry_get_method</a> (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *entry)
<a name="l00228"></a>00228 {
<a name="l00229"></a>00229   <span class="keywordflow">return</span> <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f" title="The address type (unix, tcp, etc.)">method</a>);
<a name="l00230"></a>00230 }
<a name="l00231"></a>00231 
<a name="l00243"></a>00243 <span class="keyword">const</span> <span class="keywordtype">char</span> *
<a name="l00244"></a><a class="code" href="group__DBusAddress.html#gae6f014689b49099e835b1f97d032034e">00244</a> <a class="code" href="group__DBusAddress.html#gae6f014689b49099e835b1f97d032034e" title="Returns a value from a key of an entry.">dbus_address_entry_get_value</a> (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *entry,
<a name="l00245"></a>00245                               <span class="keyword">const</span> <span class="keywordtype">char</span>       *key)
<a name="l00246"></a>00246 {
<a name="l00247"></a>00247   <a class="code" href="structDBusList.html" title="A node in a linked list.">DBusList</a> *values, *keys;
<a name="l00248"></a>00248 
<a name="l00249"></a>00249   keys = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>);
<a name="l00250"></a>00250   values = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>);
<a name="l00251"></a>00251 
<a name="l00252"></a>00252   <span class="keywordflow">while</span> (keys != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00253"></a>00253     {
<a name="l00254"></a>00254       _dbus_assert (values != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00255"></a>00255 
<a name="l00256"></a>00256       <span class="keywordflow">if</span> (<a class="code" href="group__DBusString.html#ga84f39f1bf398697920637d2982248c72" title="Checks whether a string is equal to a C string.">_dbus_string_equal_c_str</a> (keys-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>, key))
<a name="l00257"></a>00257         <span class="keywordflow">return</span> <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (values-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00258"></a>00258 
<a name="l00259"></a>00259       keys = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>, keys);
<a name="l00260"></a>00260       values = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>, values);
<a name="l00261"></a>00261     }
<a name="l00262"></a>00262   
<a name="l00263"></a>00263   <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="l00264"></a>00264 }
<a name="l00265"></a>00265 
<a name="l00266"></a>00266 <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="l00267"></a>00267 append_unescaped_value (<a class="code" href="structDBusString.html">DBusString</a>       *unescaped,
<a name="l00268"></a>00268                         <span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *escaped,
<a name="l00269"></a>00269                         <span class="keywordtype">int</span>               escaped_start,
<a name="l00270"></a>00270                         <span class="keywordtype">int</span>               escaped_len,
<a name="l00271"></a>00271                         <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>        *error)
<a name="l00272"></a>00272 {
<a name="l00273"></a>00273   <span class="keyword">const</span> <span class="keywordtype">char</span> *p;
<a name="l00274"></a>00274   <span class="keyword">const</span> <span class="keywordtype">char</span> *end;
<a name="l00275"></a>00275   <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a> ret;
<a name="l00276"></a>00276   
<a name="l00277"></a>00277   ret = <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00278"></a>00278 
<a name="l00279"></a>00279   p = <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (escaped) + escaped_start;
<a name="l00280"></a>00280   end = p + escaped_len;
<a name="l00281"></a>00281   <span class="keywordflow">while</span> (p != end)
<a name="l00282"></a>00282     {
<a name="l00283"></a>00283       <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddressInternals.html#ga0e46a8bc37d92810fe3d535019d3bad1" title="TRUE if the byte need not be escaped when found in a dbus address.">_DBUS_ADDRESS_OPTIONALLY_ESCAPED_BYTE</a> (*p))
<a name="l00284"></a>00284         {
<a name="l00285"></a>00285           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaa6ecf36e70263659f921a4ef0335db12" title="Appends a single byte to the string, returning FALSE if not enough memory.">_dbus_string_append_byte</a> (unescaped, *p))
<a name="l00286"></a>00286             <span class="keywordflow">goto</span> out;
<a name="l00287"></a>00287         }
<a name="l00288"></a>00288       <span class="keywordflow">else</span> <span class="keywordflow">if</span> (*p == <span class="charliteral">&#39;%&#39;</span>)
<a name="l00289"></a>00289         {
<a name="l00290"></a>00290           <span class="comment">/* Efficiency is king */</span>
<a name="l00291"></a>00291           <span class="keywordtype">char</span> buf[3];
<a name="l00292"></a>00292           <a class="code" href="structDBusString.html">DBusString</a> hex;
<a name="l00293"></a>00293           <span class="keywordtype">int</span> hex_end;
<a name="l00294"></a>00294           
<a name="l00295"></a>00295           ++p;
<a name="l00296"></a>00296 
<a name="l00297"></a>00297           <span class="keywordflow">if</span> ((p + 2) &gt; end)
<a name="l00298"></a>00298             {
<a name="l00299"></a>00299               <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00300"></a>00300                               <span class="stringliteral">&quot;In D-Bus address, percent character was not followed by two hex digits&quot;</span>);
<a name="l00301"></a>00301               <span class="keywordflow">goto</span> out;
<a name="l00302"></a>00302             }
<a name="l00303"></a>00303             
<a name="l00304"></a>00304           buf[0] = *p;
<a name="l00305"></a>00305           ++p;
<a name="l00306"></a>00306           buf[1] = *p;
<a name="l00307"></a>00307           buf[2] = <span class="charliteral">&#39;\0&#39;</span>;
<a name="l00308"></a>00308 
<a name="l00309"></a>00309           <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&amp;hex, buf);
<a name="l00310"></a>00310 
<a name="l00311"></a>00311           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga0a8c20d855f9ddc05718b9e2ac0e33d8" title="Decodes a string from hex encoding.">_dbus_string_hex_decode</a> (&amp;hex, 0, &amp;hex_end,
<a name="l00312"></a>00312                                         unescaped,
<a name="l00313"></a>00313                                         <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (unescaped)))
<a name="l00314"></a>00314             <span class="keywordflow">goto</span> out;
<a name="l00315"></a>00315 
<a name="l00316"></a>00316           <span class="keywordflow">if</span> (hex_end != 2)
<a name="l00317"></a>00317             {
<a name="l00318"></a>00318               <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00319"></a>00319                               <span class="stringliteral">&quot;In D-Bus address, percent character was followed by characters other than hex digits&quot;</span>);
<a name="l00320"></a>00320               <span class="keywordflow">goto</span> out;
<a name="l00321"></a>00321             }
<a name="l00322"></a>00322         }
<a name="l00323"></a>00323       <span class="keywordflow">else</span>
<a name="l00324"></a>00324         {
<a name="l00325"></a>00325           <span class="comment">/* Error, should have been escaped */</span>
<a name="l00326"></a>00326           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00327"></a>00327                           <span class="stringliteral">&quot;In D-Bus address, character &#39;%c&#39; should have been escaped\n&quot;</span>,
<a name="l00328"></a>00328                           *p);
<a name="l00329"></a>00329           <span class="keywordflow">goto</span> out;
<a name="l00330"></a>00330         }
<a name="l00331"></a>00331       
<a name="l00332"></a>00332       ++p;
<a name="l00333"></a>00333     }
<a name="l00334"></a>00334 
<a name="l00335"></a>00335   ret = <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00336"></a>00336   
<a name="l00337"></a>00337  out:
<a name="l00338"></a>00338   <span class="keywordflow">if</span> (!ret &amp;&amp; error &amp;&amp; !<a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (error))
<a name="l00339"></a>00339     _DBUS_SET_OOM (error);
<a name="l00340"></a>00340 
<a name="l00341"></a>00341   _dbus_assert (ret || error == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> || <a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (error));
<a name="l00342"></a>00342   
<a name="l00343"></a>00343   <span class="keywordflow">return</span> ret;
<a name="l00344"></a>00344 }
<a name="l00345"></a>00345 
<a name="l00362"></a>00362 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00363"></a><a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098">00363</a> <a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="keyword">const</span> <span class="keywordtype">char</span>         *address,
<a name="l00364"></a>00364                     <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> ***entry,
<a name="l00365"></a>00365                     <span class="keywordtype">int</span>                *array_len,
<a name="l00366"></a>00366                     <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>          *error)
<a name="l00367"></a>00367 {
<a name="l00368"></a>00368   <a class="code" href="structDBusString.html">DBusString</a> str;
<a name="l00369"></a>00369   <span class="keywordtype">int</span> pos, end_pos, len, i;
<a name="l00370"></a>00370   <a class="code" href="structDBusList.html" title="A node in a linked list.">DBusList</a> *entries, *link;
<a name="l00371"></a>00371   <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> **entry_array;
<a name="l00372"></a>00372 
<a name="l00373"></a>00373   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
<a name="l00374"></a>00374   
<a name="l00375"></a>00375   <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&amp;str, address);
<a name="l00376"></a>00376 
<a name="l00377"></a>00377   entries = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00378"></a>00378   pos = 0;
<a name="l00379"></a>00379   len = <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (&amp;str);
<a name="l00380"></a>00380 
<a name="l00381"></a>00381   <span class="keywordflow">if</span> (len == 0)
<a name="l00382"></a>00382   {
<a name="l00383"></a>00383     <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00384"></a>00384                     <span class="stringliteral">&quot;Empty address &#39;%s&#39;&quot;</span>, address);
<a name="l00385"></a>00385     <span class="keywordflow">goto</span> error;
<a name="l00386"></a>00386   }
<a name="l00387"></a>00387   
<a name="l00388"></a>00388   <span class="keywordflow">while</span> (pos &lt; len)
<a name="l00389"></a>00389     {
<a name="l00390"></a>00390       <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *entry;
<a name="l00391"></a>00391 
<a name="l00392"></a>00392       <span class="keywordtype">int</span> found_pos;
<a name="l00393"></a>00393 
<a name="l00394"></a>00394       entry = create_entry ();
<a name="l00395"></a>00395       <span class="keywordflow">if</span> (!entry)
<a name="l00396"></a>00396         {
<a name="l00397"></a>00397           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00398"></a>00398 
<a name="l00399"></a>00399           <span class="keywordflow">goto</span> error;
<a name="l00400"></a>00400         }
<a name="l00401"></a>00401       
<a name="l00402"></a>00402       <span class="comment">/* Append the entry */</span>
<a name="l00403"></a>00403       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusList.html#gad99045e79db46159babe69718f343053" title="Appends a value to the list.">_dbus_list_append</a> (&amp;entries, entry))
<a name="l00404"></a>00404         {
<a name="l00405"></a>00405           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00406"></a>00406           dbus_address_entry_free (entry);
<a name="l00407"></a>00407           <span class="keywordflow">goto</span> error;
<a name="l00408"></a>00408         }
<a name="l00409"></a>00409       
<a name="l00410"></a>00410       <span class="comment">/* Look for a semi-colon */</span>
<a name="l00411"></a>00411       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga5fe47873b2838339107c3e1f03d1a703" title="Finds the given substring in the string, returning TRUE and filling in the byte index where the subst...">_dbus_string_find</a> (&amp;str, pos, <span class="stringliteral">&quot;;&quot;</span>, &amp;end_pos))
<a name="l00412"></a>00412         end_pos = len;
<a name="l00413"></a>00413       
<a name="l00414"></a>00414       <span class="comment">/* Look for the colon : */</span>
<a name="l00415"></a>00415       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaf2281731c3119f946726680242a5ae02" title="Finds the given substring in the string, up to a certain position, returning TRUE and filling in the ...">_dbus_string_find_to</a> (&amp;str, pos, end_pos, <span class="stringliteral">&quot;:&quot;</span>, &amp;found_pos))
<a name="l00416"></a>00416         {
<a name="l00417"></a>00417           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>, <span class="stringliteral">&quot;Address does not contain a colon&quot;</span>);
<a name="l00418"></a>00418           <span class="keywordflow">goto</span> error;
<a name="l00419"></a>00419         }
<a name="l00420"></a>00420 
<a name="l00421"></a>00421       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaf5f13bc7ac7a623516930d26ae2589bf" title="Like _dbus_string_copy(), but can copy a segment from the middle of the source string.">_dbus_string_copy_len</a> (&amp;str, pos, found_pos - pos, &amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a2d88ca4208738ec7024655013373505f" title="The address type (unix, tcp, etc.)">method</a>, 0))
<a name="l00422"></a>00422         {
<a name="l00423"></a>00423           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00424"></a>00424           <span class="keywordflow">goto</span> error;
<a name="l00425"></a>00425         }
<a name="l00426"></a>00426           
<a name="l00427"></a>00427       pos = found_pos + 1;
<a name="l00428"></a>00428 
<a name="l00429"></a>00429       <span class="keywordflow">while</span> (pos &lt; end_pos)
<a name="l00430"></a>00430         {
<a name="l00431"></a>00431           <span class="keywordtype">int</span> comma_pos, equals_pos;
<a name="l00432"></a>00432 
<a name="l00433"></a>00433           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaf2281731c3119f946726680242a5ae02" title="Finds the given substring in the string, up to a certain position, returning TRUE and filling in the ...">_dbus_string_find_to</a> (&amp;str, pos, end_pos, <span class="stringliteral">&quot;,&quot;</span>, &amp;comma_pos))
<a name="l00434"></a>00434             comma_pos = end_pos;
<a name="l00435"></a>00435           
<a name="l00436"></a>00436           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaf2281731c3119f946726680242a5ae02" title="Finds the given substring in the string, up to a certain position, returning TRUE and filling in the ...">_dbus_string_find_to</a> (&amp;str, pos, comma_pos, <span class="stringliteral">&quot;=&quot;</span>, &amp;equals_pos) ||
<a name="l00437"></a>00437               equals_pos == pos || equals_pos + 1 == comma_pos)
<a name="l00438"></a>00438             {
<a name="l00439"></a>00439               <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>,
<a name="l00440"></a>00440                               <span class="stringliteral">&quot;&#39;=&#39; character not found or has no value following it&quot;</span>);
<a name="l00441"></a>00441               <span class="keywordflow">goto</span> error;
<a name="l00442"></a>00442             }
<a name="l00443"></a>00443           <span class="keywordflow">else</span>
<a name="l00444"></a>00444             {
<a name="l00445"></a>00445               <a class="code" href="structDBusString.html">DBusString</a> *key;
<a name="l00446"></a>00446               <a class="code" href="structDBusString.html">DBusString</a> *value;
<a name="l00447"></a>00447 
<a name="l00448"></a>00448               key = <a class="code" href="group__DBusMemory.html#gaba9d823abda7f4cadbaf5177d3b8b793" title="Safe macro for using dbus_malloc0().">dbus_new0</a> (<a class="code" href="structDBusString.html">DBusString</a>, 1);
<a name="l00449"></a>00449 
<a name="l00450"></a>00450               <span class="keywordflow">if</span> (!key)
<a name="l00451"></a>00451                 {
<a name="l00452"></a>00452                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);             
<a name="l00453"></a>00453                   <span class="keywordflow">goto</span> error;
<a name="l00454"></a>00454                 }
<a name="l00455"></a>00455 
<a name="l00456"></a>00456               value = <a class="code" href="group__DBusMemory.html#gaba9d823abda7f4cadbaf5177d3b8b793" title="Safe macro for using dbus_malloc0().">dbus_new0</a> (<a class="code" href="structDBusString.html">DBusString</a>, 1);
<a name="l00457"></a>00457               <span class="keywordflow">if</span> (!value)
<a name="l00458"></a>00458                 {
<a name="l00459"></a>00459                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00460"></a>00460                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00461"></a>00461                   <span class="keywordflow">goto</span> error;
<a name="l00462"></a>00462                 }
<a name="l00463"></a>00463               
<a name="l00464"></a>00464               <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (key))
<a name="l00465"></a>00465                 {
<a name="l00466"></a>00466                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00467"></a>00467                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00468"></a>00468                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);
<a name="l00469"></a>00469                   
<a name="l00470"></a>00470                   <span class="keywordflow">goto</span> error;
<a name="l00471"></a>00471                 }
<a name="l00472"></a>00472               
<a name="l00473"></a>00473               <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (value))
<a name="l00474"></a>00474                 {
<a name="l00475"></a>00475                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00476"></a>00476                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (key);
<a name="l00477"></a>00477 
<a name="l00478"></a>00478                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00479"></a>00479                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);              
<a name="l00480"></a>00480                   <span class="keywordflow">goto</span> error;
<a name="l00481"></a>00481                 }
<a name="l00482"></a>00482 
<a name="l00483"></a>00483               <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#gaf5f13bc7ac7a623516930d26ae2589bf" title="Like _dbus_string_copy(), but can copy a segment from the middle of the source string.">_dbus_string_copy_len</a> (&amp;str, pos, equals_pos - pos, key, 0))
<a name="l00484"></a>00484                 {
<a name="l00485"></a>00485                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00486"></a>00486                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (key);
<a name="l00487"></a>00487                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (value);
<a name="l00488"></a>00488 
<a name="l00489"></a>00489                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00490"></a>00490                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);              
<a name="l00491"></a>00491                   <span class="keywordflow">goto</span> error;
<a name="l00492"></a>00492                 }
<a name="l00493"></a>00493 
<a name="l00494"></a>00494               <span class="keywordflow">if</span> (!append_unescaped_value (value, &amp;str, equals_pos + 1,
<a name="l00495"></a>00495                                            comma_pos - equals_pos - 1, error))
<a name="l00496"></a>00496                 {
<a name="l00497"></a>00497                   _dbus_assert (error == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> || <a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (error));
<a name="l00498"></a>00498                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (key);
<a name="l00499"></a>00499                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (value);
<a name="l00500"></a>00500 
<a name="l00501"></a>00501                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00502"></a>00502                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);              
<a name="l00503"></a>00503                   <span class="keywordflow">goto</span> error;
<a name="l00504"></a>00504                 }
<a name="l00505"></a>00505 
<a name="l00506"></a>00506               <span class="keywordflow">if</span> (!<a class="code" href="group__DBusList.html#gad99045e79db46159babe69718f343053" title="Appends a value to the list.">_dbus_list_append</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a62999fb785b591efa6356b7d97729846" title="List of keys.">keys</a>, key))
<a name="l00507"></a>00507                 {
<a name="l00508"></a>00508                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);             
<a name="l00509"></a>00509                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (key);
<a name="l00510"></a>00510                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (value);
<a name="l00511"></a>00511 
<a name="l00512"></a>00512                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (key);
<a name="l00513"></a>00513                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);              
<a name="l00514"></a>00514                   <span class="keywordflow">goto</span> error;
<a name="l00515"></a>00515                 }
<a name="l00516"></a>00516 
<a name="l00517"></a>00517               <span class="keywordflow">if</span> (!<a class="code" href="group__DBusList.html#gad99045e79db46159babe69718f343053" title="Appends a value to the list.">_dbus_list_append</a> (&amp;entry-&gt;<a class="code" href="structDBusAddressEntry.html#a504d8c6e3d3b6f94a9be32a1d6ab54e8" title="List of values.">values</a>, value))
<a name="l00518"></a>00518                 {
<a name="l00519"></a>00519                   <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);             
<a name="l00520"></a>00520                   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (value);
<a name="l00521"></a>00521 
<a name="l00522"></a>00522                   <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (value);
<a name="l00523"></a>00523                   <span class="keywordflow">goto</span> error;             
<a name="l00524"></a>00524                 }
<a name="l00525"></a>00525             }
<a name="l00526"></a>00526 
<a name="l00527"></a>00527           pos = comma_pos + 1;
<a name="l00528"></a>00528         }
<a name="l00529"></a>00529 
<a name="l00530"></a>00530       pos = end_pos + 1;
<a name="l00531"></a>00531     }
<a name="l00532"></a>00532 
<a name="l00533"></a>00533   *array_len = <a class="code" href="group__DBusList.html#gaa2144a5489bb35b16b2b671488ad597c" title="Gets the length of a list.">_dbus_list_get_length</a> (&amp;entries);
<a name="l00534"></a>00534   
<a name="l00535"></a>00535   entry_array = <a class="code" href="group__DBusMemory.html#ga54ccb556e7964112a825a7f46c156ca0" title="Safe macro for using dbus_malloc().">dbus_new</a> (<a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> *, *array_len + 1);
<a name="l00536"></a>00536 
<a name="l00537"></a>00537   <span class="keywordflow">if</span> (!entry_array)
<a name="l00538"></a>00538     {
<a name="l00539"></a>00539       <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00540"></a>00540       
<a name="l00541"></a>00541       <span class="keywordflow">goto</span> error;
<a name="l00542"></a>00542     }
<a name="l00543"></a>00543   
<a name="l00544"></a>00544   entry_array [*array_len] = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00545"></a>00545 
<a name="l00546"></a>00546   link = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entries);
<a name="l00547"></a>00547   i = 0;
<a name="l00548"></a>00548   <span class="keywordflow">while</span> (link != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00549"></a>00549     {
<a name="l00550"></a>00550       entry_array[i] = link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>;
<a name="l00551"></a>00551       i++;
<a name="l00552"></a>00552       link = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entries, link);
<a name="l00553"></a>00553     }
<a name="l00554"></a>00554 
<a name="l00555"></a>00555   <a class="code" href="group__DBusList.html#gaa36d13444a050a923941c53650b72f9d" title="Frees all links in the list and sets the list head to NULL.">_dbus_list_clear</a> (&amp;entries);
<a name="l00556"></a>00556   *entry = entry_array;
<a name="l00557"></a>00557 
<a name="l00558"></a>00558   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00559"></a>00559 
<a name="l00560"></a>00560  error:
<a name="l00561"></a>00561   
<a name="l00562"></a>00562   link = <a class="code" href="group__DBusList.html#ga1e26ce4fb4acb50593bd5ed2f4eeb3ae" title="Gets the first link in the list.">_dbus_list_get_first_link</a> (&amp;entries);
<a name="l00563"></a>00563   <span class="keywordflow">while</span> (link != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00564"></a>00564     {
<a name="l00565"></a>00565       dbus_address_entry_free (link-&gt;<a class="code" href="structDBusList.html#a29ab457bcf9092252bb0c4282c727055" title="Data stored at this element.">data</a>);
<a name="l00566"></a>00566       link = <a class="code" href="group__DBusList.html#gaede4ace46d5ee497d75074bfec4490a2" title="Gets the next link in the list, or NULL if there are no more links.">_dbus_list_get_next_link</a> (&amp;entries, link);
<a name="l00567"></a>00567     }
<a name="l00568"></a>00568 
<a name="l00569"></a>00569   <a class="code" href="group__DBusList.html#gaa36d13444a050a923941c53650b72f9d" title="Frees all links in the list and sets the list head to NULL.">_dbus_list_clear</a> (&amp;entries);
<a name="l00570"></a>00570   
<a name="l00571"></a>00571   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00572"></a>00572   
<a name="l00573"></a>00573 }
<a name="l00574"></a>00574 
<a name="l00582"></a>00582 <span class="keywordtype">char</span>*
<a name="l00583"></a><a class="code" href="group__DBusAddress.html#ga818e79423595cd2a306ec1b4dc1ab7f5">00583</a> <a class="code" href="group__DBusAddress.html#ga818e79423595cd2a306ec1b4dc1ab7f5" title="Escapes the given string as a value in a key=value pair for a D-Bus address.">dbus_address_escape_value</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *value)
<a name="l00584"></a>00584 {
<a name="l00585"></a>00585   <a class="code" href="structDBusString.html">DBusString</a> escaped;
<a name="l00586"></a>00586   <a class="code" href="structDBusString.html">DBusString</a> unescaped;
<a name="l00587"></a>00587   <span class="keywordtype">char</span> *ret;
<a name="l00588"></a>00588 
<a name="l00589"></a>00589   ret = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00590"></a>00590 
<a name="l00591"></a>00591   <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&amp;unescaped, value);
<a name="l00592"></a>00592   
<a name="l00593"></a>00593   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&amp;escaped))
<a name="l00594"></a>00594     <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="l00595"></a>00595 
<a name="l00596"></a>00596   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusAddressInternals.html#ga1ecc2f460303cd70c34e7667e8b12b37" title="Appends an escaped version of one string to another string, using the D-Bus address escaping mechanis...">_dbus_address_append_escaped</a> (&amp;escaped, &amp;unescaped))
<a name="l00597"></a>00597     <span class="keywordflow">goto</span> out;
<a name="l00598"></a>00598   
<a name="l00599"></a>00599   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga556cc30c3ab032dbc63e217119f0d1f5" title="Like _dbus_string_get_data(), but removes the gotten data from the original string.">_dbus_string_steal_data</a> (&amp;escaped, &amp;ret))
<a name="l00600"></a>00600     <span class="keywordflow">goto</span> out;
<a name="l00601"></a>00601 
<a name="l00602"></a>00602  out:
<a name="l00603"></a>00603   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;escaped);
<a name="l00604"></a>00604   <span class="keywordflow">return</span> ret;
<a name="l00605"></a>00605 }
<a name="l00606"></a>00606 
<a name="l00616"></a>00616 <span class="keywordtype">char</span>*
<a name="l00617"></a><a class="code" href="group__DBusAddress.html#ga80d4e20206f8f1e9bbd2607e9f4bbb44">00617</a> <a class="code" href="group__DBusAddress.html#ga80d4e20206f8f1e9bbd2607e9f4bbb44" title="Unescapes the given string as a value in a key=value pair for a D-Bus address.">dbus_address_unescape_value</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *value,
<a name="l00618"></a>00618                              <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>  *error)
<a name="l00619"></a>00619 {
<a name="l00620"></a>00620   <a class="code" href="structDBusString.html">DBusString</a> unescaped;
<a name="l00621"></a>00621   <a class="code" href="structDBusString.html">DBusString</a> escaped;
<a name="l00622"></a>00622   <span class="keywordtype">char</span> *ret;
<a name="l00623"></a>00623   
<a name="l00624"></a>00624   ret = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00625"></a>00625 
<a name="l00626"></a>00626   <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&amp;escaped, value);
<a name="l00627"></a>00627   
<a name="l00628"></a>00628   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&amp;unescaped))
<a name="l00629"></a>00629     <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="l00630"></a>00630 
<a name="l00631"></a>00631   <span class="keywordflow">if</span> (!append_unescaped_value (&amp;unescaped, &amp;escaped,
<a name="l00632"></a>00632                                0, <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (&amp;escaped),
<a name="l00633"></a>00633                                error))
<a name="l00634"></a>00634     <span class="keywordflow">goto</span> out;
<a name="l00635"></a>00635   
<a name="l00636"></a>00636   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga556cc30c3ab032dbc63e217119f0d1f5" title="Like _dbus_string_get_data(), but removes the gotten data from the original string.">_dbus_string_steal_data</a> (&amp;unescaped, &amp;ret))
<a name="l00637"></a>00637     <span class="keywordflow">goto</span> out;
<a name="l00638"></a>00638 
<a name="l00639"></a>00639  out:
<a name="l00640"></a>00640   <span class="keywordflow">if</span> (ret == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> &amp;&amp; error &amp;&amp; !<a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (error))
<a name="l00641"></a>00641     _DBUS_SET_OOM (error);
<a name="l00642"></a>00642 
<a name="l00643"></a>00643   _dbus_assert (ret != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> || error == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> || <a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (error));
<a name="l00644"></a>00644   
<a name="l00645"></a>00645   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;unescaped);
<a name="l00646"></a>00646   <span class="keywordflow">return</span> ret;
<a name="l00647"></a>00647 }
<a name="l00648"></a>00648  <span class="comment">/* End of public API */</span>
<a name="l00650"></a>00650 
<a name="l00651"></a>00651 <span class="preprocessor">#ifdef DBUS_ENABLE_EMBEDDED_TESTS</span>
<a name="l00652"></a>00652 <span class="preprocessor"></span>
<a name="l00653"></a>00653 <span class="preprocessor">#ifndef DOXYGEN_SHOULD_SKIP_THIS</span>
<a name="l00654"></a>00654 <span class="preprocessor"></span>
<a name="l00655"></a>00655 <span class="preprocessor">#include &quot;dbus-test.h&quot;</span>
<a name="l00656"></a>00656 <span class="preprocessor">#include &lt;stdlib.h&gt;</span>
<a name="l00657"></a>00657 
<a name="l00658"></a>00658 <span class="keyword">typedef</span> <span class="keyword">struct</span>
<a name="l00659"></a>00659 {
<a name="l00660"></a>00660   <span class="keyword">const</span> <span class="keywordtype">char</span> *escaped;
<a name="l00661"></a>00661   <span class="keyword">const</span> <span class="keywordtype">char</span> *unescaped;
<a name="l00662"></a>00662 } EscapeTest;
<a name="l00663"></a>00663 
<a name="l00664"></a>00664 <span class="keyword">static</span> <span class="keyword">const</span> EscapeTest escape_tests[] = {
<a name="l00665"></a>00665   { <span class="stringliteral">&quot;abcde&quot;</span>, <span class="stringliteral">&quot;abcde&quot;</span> },
<a name="l00666"></a>00666   { <span class="stringliteral">&quot;&quot;</span>, <span class="stringliteral">&quot;&quot;</span> },
<a name="l00667"></a>00667   { <span class="stringliteral">&quot;%20%20&quot;</span>, <span class="stringliteral">&quot;  &quot;</span> },
<a name="l00668"></a>00668   { <span class="stringliteral">&quot;%24&quot;</span>, <span class="stringliteral">&quot;$&quot;</span> },
<a name="l00669"></a>00669   { <span class="stringliteral">&quot;%25&quot;</span>, <span class="stringliteral">&quot;%&quot;</span> },
<a name="l00670"></a>00670   { <span class="stringliteral">&quot;abc%24&quot;</span>, <span class="stringliteral">&quot;abc$&quot;</span> },
<a name="l00671"></a>00671   { <span class="stringliteral">&quot;%24abc&quot;</span>, <span class="stringliteral">&quot;$abc&quot;</span> },
<a name="l00672"></a>00672   { <span class="stringliteral">&quot;abc%24abc&quot;</span>, <span class="stringliteral">&quot;abc$abc&quot;</span> },
<a name="l00673"></a>00673   { <span class="stringliteral">&quot;/&quot;</span>, <span class="stringliteral">&quot;/&quot;</span> },
<a name="l00674"></a>00674   { <span class="stringliteral">&quot;-&quot;</span>, <span class="stringliteral">&quot;-&quot;</span> },
<a name="l00675"></a>00675   { <span class="stringliteral">&quot;_&quot;</span>, <span class="stringliteral">&quot;_&quot;</span> },
<a name="l00676"></a>00676   { <span class="stringliteral">&quot;A&quot;</span>, <span class="stringliteral">&quot;A&quot;</span> },
<a name="l00677"></a>00677   { <span class="stringliteral">&quot;I&quot;</span>, <span class="stringliteral">&quot;I&quot;</span> },
<a name="l00678"></a>00678   { <span class="stringliteral">&quot;Z&quot;</span>, <span class="stringliteral">&quot;Z&quot;</span> },
<a name="l00679"></a>00679   { <span class="stringliteral">&quot;a&quot;</span>, <span class="stringliteral">&quot;a&quot;</span> },
<a name="l00680"></a>00680   { <span class="stringliteral">&quot;i&quot;</span>, <span class="stringliteral">&quot;i&quot;</span> },
<a name="l00681"></a>00681   { <span class="stringliteral">&quot;z&quot;</span>, <span class="stringliteral">&quot;z&quot;</span> },
<a name="l00682"></a>00682   <span class="comment">/* Bug: https://bugs.freedesktop.org/show_bug.cgi?id=53499 */</span>
<a name="l00683"></a>00683   { <span class="stringliteral">&quot;%c3%b6&quot;</span>, <span class="stringliteral">&quot;\xc3\xb6&quot;</span> }
<a name="l00684"></a>00684 };
<a name="l00685"></a>00685 
<a name="l00686"></a>00686 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* invalid_escaped_values[] = {
<a name="l00687"></a>00687   <span class="stringliteral">&quot;%a&quot;</span>,
<a name="l00688"></a>00688   <span class="stringliteral">&quot;%q&quot;</span>,
<a name="l00689"></a>00689   <span class="stringliteral">&quot;%az&quot;</span>,
<a name="l00690"></a>00690   <span class="stringliteral">&quot;%%&quot;</span>,
<a name="l00691"></a>00691   <span class="stringliteral">&quot;%$$&quot;</span>,
<a name="l00692"></a>00692   <span class="stringliteral">&quot;abc%a&quot;</span>,
<a name="l00693"></a>00693   <span class="stringliteral">&quot;%axyz&quot;</span>,
<a name="l00694"></a>00694   <span class="stringliteral">&quot;%&quot;</span>,
<a name="l00695"></a>00695   <span class="stringliteral">&quot;$&quot;</span>,
<a name="l00696"></a>00696   <span class="stringliteral">&quot; &quot;</span>,
<a name="l00697"></a>00697 };
<a name="l00698"></a>00698 
<a name="l00699"></a>00699 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00700"></a>00700 _dbus_address_test (<span class="keywordtype">void</span>)
<a name="l00701"></a>00701 {
<a name="l00702"></a>00702   <a class="code" href="structDBusAddressEntry.html" title="Internals of DBusAddressEntry.">DBusAddressEntry</a> **entries;
<a name="l00703"></a>00703   <span class="keywordtype">int</span> len;
<a name="l00704"></a>00704   <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> error = <a class="code" href="group__DBusErrorInternals.html#ga961cc70e3891282a65205c4c8418d88e" title="Expands to a suitable initializer for a DBusError on the stack.">DBUS_ERROR_INIT</a>;
<a name="l00705"></a>00705   <span class="keywordtype">int</span> i;
<a name="l00706"></a>00706 
<a name="l00707"></a>00707   i = 0;
<a name="l00708"></a>00708   <span class="keywordflow">while</span> (i &lt; _DBUS_N_ELEMENTS (escape_tests))
<a name="l00709"></a>00709     {
<a name="l00710"></a>00710       <span class="keyword">const</span> EscapeTest *test = &amp;escape_tests[i];
<a name="l00711"></a>00711       <span class="keywordtype">char</span> *escaped;
<a name="l00712"></a>00712       <span class="keywordtype">char</span> *unescaped;
<a name="l00713"></a>00713 
<a name="l00714"></a>00714       escaped = <a class="code" href="group__DBusAddress.html#ga818e79423595cd2a306ec1b4dc1ab7f5" title="Escapes the given string as a value in a key=value pair for a D-Bus address.">dbus_address_escape_value</a> (test-&gt;unescaped);
<a name="l00715"></a>00715       <span class="keywordflow">if</span> (escaped == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00716"></a>00716         _dbus_assert_not_reached (<span class="stringliteral">&quot;oom&quot;</span>);
<a name="l00717"></a>00717 
<a name="l00718"></a>00718       <span class="keywordflow">if</span> (strcmp (escaped, test-&gt;escaped) != 0)
<a name="l00719"></a>00719         {
<a name="l00720"></a>00720           <a class="code" href="group__DBusInternalsUtils.html#gabea2c16d6d3fe7c4eb5b9496fc877f84" title="Prints a warning message to stderr.">_dbus_warn</a> (<span class="stringliteral">&quot;Escaped &#39;%s&#39; as &#39;%s&#39; should have been &#39;%s&#39;\n&quot;</span>,
<a name="l00721"></a>00721                       test-&gt;unescaped, escaped, test-&gt;escaped);
<a name="l00722"></a>00722           exit (1);
<a name="l00723"></a>00723         }
<a name="l00724"></a>00724       <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (escaped);
<a name="l00725"></a>00725 
<a name="l00726"></a>00726       unescaped = <a class="code" href="group__DBusAddress.html#ga80d4e20206f8f1e9bbd2607e9f4bbb44" title="Unescapes the given string as a value in a key=value pair for a D-Bus address.">dbus_address_unescape_value</a> (test-&gt;escaped, &amp;error);
<a name="l00727"></a>00727       <span class="keywordflow">if</span> (unescaped == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00728"></a>00728         {
<a name="l00729"></a>00729           <a class="code" href="group__DBusInternalsUtils.html#gabea2c16d6d3fe7c4eb5b9496fc877f84" title="Prints a warning message to stderr.">_dbus_warn</a> (<span class="stringliteral">&quot;Failed to unescape &#39;%s&#39;: %s\n&quot;</span>,
<a name="l00730"></a>00730                       test-&gt;escaped, error.<a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a>);
<a name="l00731"></a>00731           <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00732"></a>00732           exit (1);
<a name="l00733"></a>00733         }
<a name="l00734"></a>00734 
<a name="l00735"></a>00735       <span class="keywordflow">if</span> (strcmp (unescaped, test-&gt;unescaped) != 0)
<a name="l00736"></a>00736         {
<a name="l00737"></a>00737           <a class="code" href="group__DBusInternalsUtils.html#gabea2c16d6d3fe7c4eb5b9496fc877f84" title="Prints a warning message to stderr.">_dbus_warn</a> (<span class="stringliteral">&quot;Unescaped &#39;%s&#39; as &#39;%s&#39; should have been &#39;%s&#39;\n&quot;</span>,
<a name="l00738"></a>00738                       test-&gt;escaped, unescaped, test-&gt;unescaped);
<a name="l00739"></a>00739           exit (1);
<a name="l00740"></a>00740         }
<a name="l00741"></a>00741       <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (unescaped);
<a name="l00742"></a>00742       
<a name="l00743"></a>00743       ++i;
<a name="l00744"></a>00744     }
<a name="l00745"></a>00745 
<a name="l00746"></a>00746   i = 0;
<a name="l00747"></a>00747   <span class="keywordflow">while</span> (i &lt; _DBUS_N_ELEMENTS (invalid_escaped_values))
<a name="l00748"></a>00748     {
<a name="l00749"></a>00749       <span class="keywordtype">char</span> *unescaped;
<a name="l00750"></a>00750 
<a name="l00751"></a>00751       unescaped = <a class="code" href="group__DBusAddress.html#ga80d4e20206f8f1e9bbd2607e9f4bbb44" title="Unescapes the given string as a value in a key=value pair for a D-Bus address.">dbus_address_unescape_value</a> (invalid_escaped_values[i],
<a name="l00752"></a>00752                                                &amp;error);
<a name="l00753"></a>00753       <span class="keywordflow">if</span> (unescaped != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00754"></a>00754         {
<a name="l00755"></a>00755           <a class="code" href="group__DBusInternalsUtils.html#gabea2c16d6d3fe7c4eb5b9496fc877f84" title="Prints a warning message to stderr.">_dbus_warn</a> (<span class="stringliteral">&quot;Should not have successfully unescaped &#39;%s&#39; to &#39;%s&#39;\n&quot;</span>,
<a name="l00756"></a>00756                       invalid_escaped_values[i], unescaped);
<a name="l00757"></a>00757           <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (unescaped);
<a name="l00758"></a>00758           exit (1);
<a name="l00759"></a>00759         }
<a name="l00760"></a>00760 
<a name="l00761"></a>00761       _dbus_assert (<a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (&amp;error));
<a name="l00762"></a>00762       <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00763"></a>00763 
<a name="l00764"></a>00764       ++i;
<a name="l00765"></a>00765     }
<a name="l00766"></a>00766   
<a name="l00767"></a>00767   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;unix:path=/tmp/foo;debug:name=test,sliff=sloff;&quot;</span>,
<a name="l00768"></a>00768                            &amp;entries, &amp;len, &amp;error))
<a name="l00769"></a>00769     _dbus_assert_not_reached (<span class="stringliteral">&quot;could not parse address&quot;</span>);
<a name="l00770"></a>00770   _dbus_assert (len == 2);
<a name="l00771"></a>00771   _dbus_assert (strcmp (<a class="code" href="group__DBusAddress.html#gae6f014689b49099e835b1f97d032034e" title="Returns a value from a key of an entry.">dbus_address_entry_get_value</a> (entries[0], <span class="stringliteral">&quot;path&quot;</span>), <span class="stringliteral">&quot;/tmp/foo&quot;</span>) == 0);
<a name="l00772"></a>00772   _dbus_assert (strcmp (<a class="code" href="group__DBusAddress.html#gae6f014689b49099e835b1f97d032034e" title="Returns a value from a key of an entry.">dbus_address_entry_get_value</a> (entries[1], <span class="stringliteral">&quot;name&quot;</span>), <span class="stringliteral">&quot;test&quot;</span>) == 0);
<a name="l00773"></a>00773   _dbus_assert (strcmp (<a class="code" href="group__DBusAddress.html#gae6f014689b49099e835b1f97d032034e" title="Returns a value from a key of an entry.">dbus_address_entry_get_value</a> (entries[1], <span class="stringliteral">&quot;sliff&quot;</span>), <span class="stringliteral">&quot;sloff&quot;</span>) == 0);
<a name="l00774"></a>00774   
<a name="l00775"></a>00775   <a class="code" href="group__DBusAddress.html#ga37a7009b07cf991ff07f3e86d71bf352" title="Frees a NULL-terminated array of address entries.">dbus_address_entries_free</a> (entries);
<a name="l00776"></a>00776 
<a name="l00777"></a>00777   <span class="comment">/* Different possible errors */</span>
<a name="l00778"></a>00778   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00779"></a>00779     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00780"></a>00780   <span class="keywordflow">else</span>
<a name="l00781"></a>00781     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00782"></a>00782 
<a name="l00783"></a>00783   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00784"></a>00784     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00785"></a>00785   <span class="keywordflow">else</span>
<a name="l00786"></a>00786     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00787"></a>00787   
<a name="l00788"></a>00788   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:bar&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00789"></a>00789     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00790"></a>00790   <span class="keywordflow">else</span>
<a name="l00791"></a>00791     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00792"></a>00792   
<a name="l00793"></a>00793   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:bar,baz&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00794"></a>00794     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00795"></a>00795   <span class="keywordflow">else</span>
<a name="l00796"></a>00796     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00797"></a>00797   
<a name="l00798"></a>00798   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:bar=foo,baz&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00799"></a>00799     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00800"></a>00800   <span class="keywordflow">else</span>
<a name="l00801"></a>00801     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00802"></a>00802   
<a name="l00803"></a>00803   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:bar=foo;baz&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00804"></a>00804     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00805"></a>00805   <span class="keywordflow">else</span>
<a name="l00806"></a>00806     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00807"></a>00807   
<a name="l00808"></a>00808   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:=foo&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00809"></a>00809     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00810"></a>00810   <span class="keywordflow">else</span>
<a name="l00811"></a>00811     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00812"></a>00812   
<a name="l00813"></a>00813   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:foo=&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00814"></a>00814     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00815"></a>00815   <span class="keywordflow">else</span>
<a name="l00816"></a>00816     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00817"></a>00817 
<a name="l00818"></a>00818   <span class="keywordflow">if</span> (<a class="code" href="group__DBusAddress.html#ga3cbf5947262b79601598276c720e2098" title="Parses an address string of the form:">dbus_parse_address</a> (<span class="stringliteral">&quot;foo:foo,bar=baz&quot;</span>, &amp;entries, &amp;len, &amp;error))
<a name="l00819"></a>00819     _dbus_assert_not_reached (<span class="stringliteral">&quot;Parsed incorrect address.&quot;</span>);
<a name="l00820"></a>00820   <span class="keywordflow">else</span>
<a name="l00821"></a>00821     <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00822"></a>00822 
<a name="l00823"></a>00823   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00824"></a>00824 }
<a name="l00825"></a>00825 
<a name="l00826"></a>00826 <span class="preprocessor">#endif </span><span class="comment">/* !DOXYGEN_SHOULD_SKIP_THIS */</span>
<a name="l00827"></a>00827 
<a name="l00828"></a>00828 <span class="preprocessor">#endif</span>
</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>