<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>DBusMessage</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.2.15 -->
<center>
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="modules.html">Modules</a> <a class="qindex" href="annotated.html">Data Structures</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Data Fields</a> <a class="qindex" href="pages.html">Related Pages</a> </center>
<hr><h1>DBusMessage<br>
<small>
[<a class="el" href="group__DBus.html">D-BUS message system public API</a>]</small>
</h1>Message to be sent or received over a <a class="el" href="structDBusConnection.html">DBusConnection</a>.
<a href="#_details">More...</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=2><br><h2>Typedefs</h2></td></tr>
<tr><td nowrap align=right valign=top><a name="a113" doxytag="DBusMessage::DBusMessage"></a>
typedef DBusMessage </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a113">DBusMessage</a></td></tr>
<tr><td> </td><td><font size=-1><em>Opaque data type representing a message received from or to be sent to another application.</em></font><br><br></td></tr>
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a5">dbus_message_new</a> (int message_type)</td></tr>
<tr><td> </td><td><font size=-1><em>Constructs a new message of the given message type.</em> <a href="#a5">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a6">dbus_message_new_method_call</a> (const char *service, const char *path, const char *interface, const char *method)</td></tr>
<tr><td> </td><td><font size=-1><em>Constructs a new message to invoke a method on a remote object.</em> <a href="#a6">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a7">dbus_message_new_method_return</a> (DBusMessage *method_call)</td></tr>
<tr><td> </td><td><font size=-1><em>Constructs a message that is a reply to a method call.</em> <a href="#a7">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a8">dbus_message_new_signal</a> (const char *path, const char *interface, const char *name)</td></tr>
<tr><td> </td><td><font size=-1><em>Constructs a new message representing a signal emission.</em> <a href="#a8">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a9">dbus_message_new_error</a> (DBusMessage *reply_to, const char *error_name, const char *error_message)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a new message that is an error reply to a certain message.</em> <a href="#a9">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a10">dbus_message_new_error_printf</a> (DBusMessage *reply_to, const char *error_name, const char *error_format,...)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a new message that is an error reply to a certain message.</em> <a href="#a10">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a11">dbus_message_copy</a> (const DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a new message that is an exact replica of the message specified, except that its refcount is set to 1.</em> <a href="#a11">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusMessage * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a12">dbus_message_ref</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Increments the reference count of a DBusMessage.</em> <a href="#a12">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Decrements the reference count of a DBusMessage.</em> <a href="#a14">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>int </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a15">dbus_message_get_type</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the type of a message.</em> <a href="#a15">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a16">dbus_message_set_path</a> (DBusMessage *message, const char *object_path)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or the one a signal is being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a16">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a17">dbus_message_get_path</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a17">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a18">dbus_message_get_path_decomposed</a> (DBusMessage *message, char ***path)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL) in a decomposed format (one array element per path component).</em> <a href="#a18">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a19">dbus_message_set_interface</a> (DBusMessage *message, const char *interface)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the interface this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or the interface a signal is being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a19">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a20">dbus_message_get_interface</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the interface this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a20">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a21">dbus_message_set_member</a> (DBusMessage *message, const char *member)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the interface member being invoked (DBUS_MESSAGE_TYPE_METHOD_CALL) or emitted (DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a21">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a22">dbus_message_get_member</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the interface member being invoked (DBUS_MESSAGE_TYPE_METHOD_CALL) or emitted (DBUS_MESSAGE_TYPE_SIGNAL).</em> <a href="#a22">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a23">dbus_message_set_error_name</a> (DBusMessage *message, const char *error_name)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the name of the error (DBUS_MESSAGE_TYPE_ERROR).</em> <a href="#a23">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a24">dbus_message_get_error_name</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the error name (DBUS_MESSAGE_TYPE_ERROR only).</em> <a href="#a24">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a25">dbus_message_set_destination</a> (DBusMessage *message, const char *destination)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the message's destination service.</em> <a href="#a25">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a26">dbus_message_get_destination</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the destination service of a message.</em> <a href="#a26">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a27">dbus_message_append_args</a> (DBusMessage *message, int first_arg_type,...)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends fields to a message given a variable argument list.</em> <a href="#a27">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a28">dbus_message_get_args</a> (DBusMessage *message, <a class="el" href="structDBusError.html">DBusError</a> *error, int first_arg_type,...)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets arguments from a message given a variable argument list.</em> <a href="#a28">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a29">dbus_message_get_args_valist</a> (DBusMessage *message, <a class="el" href="structDBusError.html">DBusError</a> *error, int first_arg_type, va_list var_args)</td></tr>
<tr><td> </td><td><font size=-1><em>This function takes a va_list for use by language bindings.</em> <a href="#a29">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a30">dbus_message_iter_get_args</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusError.html">DBusError</a> *error, int first_arg_type,...)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets arguments from a message iterator given a variable argument list.</em> <a href="#a30">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a31">dbus_message_iter_init</a> (DBusMessage *message, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Initializes a <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> representing the arguments of the message passed in.</em> <a href="#a31">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a35">dbus_message_iter_has_next</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks if an iterator has any more fields.</em> <a href="#a35">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a36">dbus_message_iter_next</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Moves the iterator to the next field.</em> <a href="#a36">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>int </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a37">dbus_message_iter_get_arg_type</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the argument type of the argument that the message iterator points at.</em> <a href="#a37">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>int </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a39">dbus_message_iter_get_array_type</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the element type of the array that the message iterator points at.</em> <a href="#a39">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a40">dbus_message_iter_get_string</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the string value that an iterator may point to.</em> <a href="#a40">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a41">dbus_message_iter_get_object_path</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the object path value that an iterator may point to.</em> <a href="#a41">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a42">dbus_message_iter_get_custom</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, char **name, unsigned char **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the name and data from a custom type that an iterator may point to.</em> <a href="#a42">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a44">dbus_message_iter_get_args_valist</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusError.html">DBusError</a> *error, int first_arg_type, va_list var_args)</td></tr>
<tr><td> </td><td><font size=-1><em>This function takes a va_list for use by language bindings.</em> <a href="#a44">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>unsigned char </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a45">dbus_message_iter_get_byte</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the byte value that an iterator may point to.</em> <a href="#a45">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a46">dbus_message_iter_get_boolean</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the boolean value that an iterator may point to.</em> <a href="#a46">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a47">dbus_message_iter_get_int32</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 32 bit signed integer value that an iterator may point to.</em> <a href="#a47">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_uint32</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 32 bit unsigned integer value that an iterator may point to.</em> <a href="#a48">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a49">dbus_message_iter_get_int64</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 64 bit signed integer value that an iterator may point to.</em> <a href="#a49">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a50">dbus_message_iter_get_uint64</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 64 bit unsigned integer value that an iterator may point to.</em> <a href="#a50">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>double </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a51">dbus_message_iter_get_double</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the double value that an iterator may point to.</em> <a href="#a51">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a52">dbus_message_iter_init_array_iterator</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *array_iter, int *array_type)</td></tr>
<tr><td> </td><td><font size=-1><em>Initializes an iterator for the array that the iterator may point to.</em> <a href="#a52">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a53">dbus_message_iter_init_dict_iterator</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *dict_iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Initializes an iterator for the dict that the iterator may point to.</em> <a href="#a53">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a55">dbus_message_iter_get_byte_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, unsigned char **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the byte array that the iterator may point to.</em> <a href="#a55">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a56">dbus_message_iter_get_boolean_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, unsigned char **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the boolean array that the iterator may point to.</em> <a href="#a56">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a57">dbus_message_iter_get_int32_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 32 bit signed integer array that the iterator may point to.</em> <a href="#a57">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a58">dbus_message_iter_get_uint32_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 32 bit unsigned integer array that the iterator may point to.</em> <a href="#a58">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a59">dbus_message_iter_get_int64_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 64 bit signed integer array that the iterator may point to.</em> <a href="#a59">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a60">dbus_message_iter_get_uint64_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the 64 bit unsigned integer array that the iterator may point to.</em> <a href="#a60">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a61">dbus_message_iter_get_double_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, double **value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the double array that the iterator may point to.</em> <a href="#a61">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a62">dbus_message_iter_get_string_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, char ***value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the string array that the iterator may point to.</em> <a href="#a62">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a63">dbus_message_iter_get_object_path_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, char ***value, int *len)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the object path array that the iterator may point to.</em> <a href="#a63">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a64">dbus_message_iter_get_dict_key</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the key name fot the dict entry that an iterator may point to.</em> <a href="#a64">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a65">dbus_message_append_iter_init</a> (DBusMessage *message, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Initializes a <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> pointing to the end of the message.</em> <a href="#a65">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a70">dbus_message_iter_append_nil</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a nil value to the message.</em> <a href="#a70">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a72">dbus_message_iter_append_boolean</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a boolean value to the message.</em> <a href="#a72">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a73">dbus_message_iter_append_byte</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, unsigned char value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a byte to the message.</em> <a href="#a73">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a74">dbus_message_iter_append_int32</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 32 bit signed integer to the message.</em> <a href="#a74">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a75">dbus_message_iter_append_uint32</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 32 bit unsigned integer to the message.</em> <a href="#a75">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a76">dbus_message_iter_append_int64</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 64 bit signed integer to the message.</em> <a href="#a76">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a77">dbus_message_iter_append_uint64</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 64 bit unsigned integer to the message.</em> <a href="#a77">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a78">dbus_message_iter_append_double</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, double value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a double value to the message.</em> <a href="#a78">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a79">dbus_message_iter_append_string</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char *value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a UTF-8 string to the message.</em> <a href="#a79">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a80">dbus_message_iter_append_object_path</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char *value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends an object path to the message.</em> <a href="#a80">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a81">dbus_message_iter_append_custom</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char *name, const unsigned char *data, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a custom type data chunk to the message.</em> <a href="#a81">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a82">dbus_message_iter_append_dict_key</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char *value)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a dict key name to the message.</em> <a href="#a82">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a85">dbus_message_iter_append_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *array_iter, int element_type)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends an array to the message and initializes an iterator that can be used to append to the array.</em> <a href="#a85">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a86">dbus_message_iter_append_dict</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *dict_iter)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a dict to the message and initializes an iterator that can be used to append to the dict.</em> <a href="#a86">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a88">dbus_message_append_args_valist</a> (DBusMessage *message, int first_arg_type, va_list var_args)</td></tr>
<tr><td> </td><td><font size=-1><em>This function takes a va_list for use by language bindings.</em> <a href="#a88">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a89">dbus_message_iter_append_boolean_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, unsigned const char *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a boolean array to the message.</em> <a href="#a89">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a90">dbus_message_iter_append_int32_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const <a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 32 bit signed integer array to the message.</em> <a href="#a90">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a91">dbus_message_iter_append_uint32_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const <a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 32 bit unsigned integer array to the message.</em> <a href="#a91">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a92">dbus_message_iter_append_int64_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const <a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 64 bit signed integer array to the message.</em> <a href="#a92">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a93">dbus_message_iter_append_uint64_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const <a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a 64 bit unsigned integer array to the message.</em> <a href="#a93">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a94">dbus_message_iter_append_double_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const double *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a double array to the message.</em> <a href="#a94">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a95">dbus_message_iter_append_byte_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, unsigned const char *value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a byte array to the message.</em> <a href="#a95">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a96">dbus_message_iter_append_string_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char **value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends a string array to the message.</em> <a href="#a96">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a97">dbus_message_iter_append_object_path_array</a> (<a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> *iter, const char **value, int len)</td></tr>
<tr><td> </td><td><font size=-1><em>Appends an object path array to the message.</em> <a href="#a97">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a98">dbus_message_set_sender</a> (DBusMessage *message, const char *sender)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the message sender.</em> <a href="#a98">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a99">dbus_message_set_no_reply</a> (DBusMessage *message, <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> no_reply)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets a flag indicating that the message does not want a reply; if this flag is set, the other end of the connection may (but is not required to) optimize by not sending method return or error replies.</em> <a href="#a99">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a100">dbus_message_get_no_reply</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message does not expect a reply.</em> <a href="#a100">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a101">dbus_message_set_auto_activation</a> (DBusMessage *message, <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> auto_activation)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets a flag indicating that the addressed service will be auto-activated before the message is delivered.</em> <a href="#a101">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a102">dbus_message_get_auto_activation</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message will cause the addressed service to be auto-activated.</em> <a href="#a102">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a103">dbus_message_get_sender</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the service which originated this message, or <a class="el" href="group__DBusMacros.html#a4">NULL</a> if unknown or inapplicable.</em> <a href="#a103">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a104">dbus_message_get_signature</a> (DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the type signature of the message, i.e.</em> <a href="#a104">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a106">dbus_message_is_method_call</a> (DBusMessage *message, const char *interface, const char *method)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message is a method call with the given interface and member fields.</em> <a href="#a106">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a107">dbus_message_is_signal</a> (DBusMessage *message, const char *interface, const char *signal_name)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message is a signal with the given interface and member fields.</em> <a href="#a107">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a108">dbus_message_is_error</a> (DBusMessage *message, const char *error_name)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message is an error reply with the given error name.</em> <a href="#a108">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a109">dbus_message_has_destination</a> (DBusMessage *message, const char *service)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message was sent to the given service.</em> <a href="#a109">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a110">dbus_message_has_sender</a> (DBusMessage *message, const char *service)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message has the given service as its sender.</em> <a href="#a110">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a111">dbus_message_has_signature</a> (DBusMessage *message, const char *signature)</td></tr>
<tr><td> </td><td><font size=-1><em>Checks whether the message has the given signature; see <a class="el" href="group__DBusMessage.html#a104">dbus_message_get_signature</a>() for more details on what the signature looks like.</em> <a href="#a111">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusMessage.html#a112">dbus_set_error_from_message</a> (<a class="el" href="structDBusError.html">DBusError</a> *error, DBusMessage *message)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets a DBusError based on the contents of the given message.</em> <a href="#a112">More...</a><em></em></font><br><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Message to be sent or received over a <a class="el" href="structDBusConnection.html">DBusConnection</a>.
<p>
<p>
A DBusMessage is the most basic unit of communication over a <a class="el" href="structDBusConnection.html">DBusConnection</a>. A <a class="el" href="structDBusConnection.html">DBusConnection</a> represents a stream of messages received from a remote application, and a stream of messages sent to a remote application. <hr><h2>Function Documentation</h2>
<a name="a27" doxytag="dbus-message.c::dbus_message_append_args"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_append_args </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>... </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends fields to a message given a variable argument list.
<p>
The variable argument list should contain the type of the argument followed by the value to add. Array values are specified by an int typecode followed by a pointer to the array followed by an int giving the length of the array. The argument list must be terminated with DBUS_TYPE_INVALID.
<p>
This function doesn't support dicts or non-fundamental arrays.
<p>
This function supports DBUS_TYPE_INT64 and DBUS_TYPE_UINT64 only if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
type of the first argument </td></tr>
<tr><td valign=top><em>...</em> </td><td>
value of first argument, list of additional type-value pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02032">2032</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a88" doxytag="dbus-message.c::dbus_message_append_args_valist"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_append_args_valist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>va_list </td>
<td class="mdname" nowrap> <em>var_args</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
This function takes a va_list for use by language bindings.
<p>
It's otherwise the same as <a class="el" href="group__DBusMessage.html#a27">dbus_message_append_args</a>().
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000035">Todo: </a></b><dd>
: Shouldn't this function clean up the changes to the message on failures? (Yes)</dl>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a39">dbus_message_append_args</a>. </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
type of first argument </td></tr>
<tr><td valign=top><em>var_args</em> </td><td>
value of first argument, then list of type/value pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03963">3963</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>. </td>
</tr>
</table>
<a name="a65" doxytag="dbus-message.c::dbus_message_append_iter_init"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void dbus_message_append_iter_init </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Initializes a <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> pointing to the end of the message.
<p>
This iterator can be used to append data to the message.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>iter</em> </td><td>
pointer to an iterator to initialize </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03296">3296</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a11" doxytag="dbus-message.c::dbus_message_copy"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_copy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a new message that is an exact replica of the message specified, except that its refcount is set to 1.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the new message. </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01649">1649</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00090">client_serial</a>, <a class="el" href="dbus-message_8c-source.html#l00081">header</a>, <a class="el" href="dbus-message_8c-source.html#l00086">header_fields</a>, <a class="el" href="dbus-message_8c-source.html#l00093">header_padding</a>, <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>, <a class="el" href="dbus-message_8c-source.html#l00079">refcount</a>, <a class="el" href="dbus-message_8c-source.html#l00091">reply_serial</a>, and <a class="el" href="dbus-sysdeps_8h-source.html#l00192">DBusAtomic::value</a>. </td>
</tr>
</table>
<a name="a28" doxytag="dbus-message.c::dbus_message_get_args"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_get_args </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>... </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets arguments from a message given a variable argument list.
<p>
The variable argument list should contain the type of the argumen followed by a pointer to where the value should be stored. The list is terminated with DBUS_TYPE_INVALID.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>error</em> </td><td>
error to be filled in on failure </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
the first argument type </td></tr>
<tr><td valign=top><em>...</em> </td><td>
location for first argument value, then list of type-location pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if the error was set </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02063">2063</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a29" doxytag="dbus-message.c::dbus_message_get_args_valist"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_get_args_valist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>va_list </td>
<td class="mdname" nowrap> <em>var_args</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
This function takes a va_list for use by language bindings.
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000031">Todo: </a></b><dd>
We need to free the argument data when an error occurs.</dl>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a41">dbus_message_get_args</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>error</em> </td><td>
error to be filled in </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
type of the first argument </td></tr>
<tr><td valign=top><em>var_args</em> </td><td>
return location for first argument, followed by list of type/location pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if error was set </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02094">2094</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a102" doxytag="dbus-message.c::dbus_message_get_auto_activation"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_get_auto_activation </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message will cause the addressed service to be auto-activated.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message will use auto-activation </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04397">4397</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00081">header</a>. </td>
</tr>
</table>
<a name="a26" doxytag="dbus-message.c::dbus_message_get_destination"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_destination </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the destination service of a message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the message destination service (should not be freed) </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02004">2004</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a24" doxytag="dbus-message.c::dbus_message_get_error_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_error_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the error name (DBUS_MESSAGE_TYPE_ERROR only).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the error name (should not be freed) </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01968">1968</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a20" doxytag="dbus-message.c::dbus_message_get_interface"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_interface </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the interface this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).
<p>
The interface name is fully-qualified (namespaced).<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the message interface (should not be freed) </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01891">1891</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a22" doxytag="dbus-message.c::dbus_message_get_member"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_member </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the interface member being invoked (DBUS_MESSAGE_TYPE_METHOD_CALL) or emitted (DBUS_MESSAGE_TYPE_SIGNAL).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the member name (should not be freed) </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01930">1930</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a100" doxytag="dbus-message.c::dbus_message_get_no_reply"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_get_no_reply </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message does not expect a reply.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message sender isn't waiting for a reply </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04351">4351</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00081">header</a>. </td>
</tr>
</table>
<a name="a17" doxytag="dbus-message.c::dbus_message_get_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_path </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the path (should not be freed) </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01824">1824</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a18" doxytag="dbus-message.c::dbus_message_get_path_decomposed"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_get_path_decomposed </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>char *** </td>
<td class="mdname" nowrap> <em>path</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL) in a decomposed format (one array element per path component).
<p>
Free the returned array with <a class="el" href="group__DBusMemory.html#a4">dbus_free_string_array</a>().
<p>
An empty but non-NULL path array means the path "/". So the path "/foo/bar" becomes { "foo", "bar", NULL } and the path "/" becomes { NULL }.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>path</em> </td><td>
place to store allocated array of path components; <a class="el" href="group__DBusMacros.html#a4">NULL</a> set here if no path field exists </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if no memory to allocate the array </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01847">1847</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a103" doxytag="dbus-message.c::dbus_message_get_sender"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_sender </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the service which originated this message, or <a class="el" href="group__DBusMacros.html#a4">NULL</a> if unknown or inapplicable.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the service name or <a class="el" href="group__DBusMacros.html#a4">NULL</a> </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04416">4416</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a104" doxytag="dbus-message.c::dbus_message_get_signature"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* dbus_message_get_signature </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the type signature of the message, i.e.
<p>
the arguments in the message payload. The signature includes only "in" arguments for DBUS_MESSAGE_TYPE_METHOD_CALL and only "out" arguments for DBUS_MESSAGE_TYPE_METHOD_RETURN, so is slightly different from what you might expect (it does not include the signature of the entire C++-style method).
<p>
The signature is a string made up of type codes such as DBUS_TYPE_STRING. The string is terminated with nul (nul is also the value of DBUS_TYPE_INVALID).<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the type signature </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04441">4441</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a15" doxytag="dbus-message.c::dbus_message_get_type"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int dbus_message_get_type </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the type of a message.
<p>
Types include DBUS_MESSAGE_TYPE_METHOD_CALL, DBUS_MESSAGE_TYPE_METHOD_RETURN, DBUS_MESSAGE_TYPE_ERROR, DBUS_MESSAGE_TYPE_SIGNAL, but other types are allowed and all code must silently ignore messages of unknown type. DBUS_MESSAGE_TYPE_INVALID will never be returned, however.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the type of the message </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01783">1783</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00081">header</a>. </td>
</tr>
</table>
<a name="a109" doxytag="dbus-message.c::dbus_message_has_destination"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_has_destination </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>service</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message was sent to the given service.
<p>
If the message has no service specified or has a different name, returns <a class="el" href="group__DBusMacros.html#a3">FALSE</a>.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>service</em> </td><td>
the service to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>)</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message has the given destination service </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04576">4576</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a110" doxytag="dbus-message.c::dbus_message_has_sender"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_has_sender </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>service</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message has the given service as its sender.
<p>
If the message has no sender specified or has a different sender, returns <a class="el" href="group__DBusMacros.html#a3">FALSE</a>. Note that if a peer application owns multiple services, its messages will have only one of those services as the sender (usually the base service). So you can't use this function to prove the sender didn't own service Foo, you can only use it to prove that it did.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>service</em> </td><td>
the service to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>)</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message has the given origin service </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04607">4607</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a111" doxytag="dbus-message.c::dbus_message_has_signature"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_has_signature </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>signature</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message has the given signature; see <a class="el" href="group__DBusMessage.html#a104">dbus_message_get_signature</a>() for more details on what the signature looks like.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>signature</em> </td><td>
typecode array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if message has the given signature </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04633">4633</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a108" doxytag="dbus-message.c::dbus_message_is_error"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_is_error </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_name</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message is an error reply with the given error name.
<p>
If the message is not DBUS_MESSAGE_TYPE_ERROR, or has a different name, returns <a class="el" href="group__DBusMacros.html#a3">FALSE</a>.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>error_name</em> </td><td>
the name to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>)</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message is the specified error </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04545">4545</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a106" doxytag="dbus-message.c::dbus_message_is_method_call"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_is_method_call </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>interface</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>method</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message is a method call with the given interface and member fields.
<p>
If the message is not DBUS_MESSAGE_TYPE_METHOD_CALL, or has a different interface or member field, returns <a class="el" href="group__DBusMacros.html#a3">FALSE</a>.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>interface</em> </td><td>
the name to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>) </td></tr>
<tr><td valign=top><em>method</em> </td><td>
the name to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>)</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message is the specified method call </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04495">4495</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a107" doxytag="dbus-message.c::dbus_message_is_signal"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_is_signal </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>interface</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>signal_name</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks whether the message is a signal with the given interface and member fields.
<p>
If the message is not DBUS_MESSAGE_TYPE_SIGNAL, or has a different interface or member field, returns <a class="el" href="group__DBusMacros.html#a3">FALSE</a>.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>interface</em> </td><td>
the name to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>) </td></tr>
<tr><td valign=top><em>signal_name</em> </td><td>
the name to check (must not be <a class="el" href="group__DBusMacros.html#a4">NULL</a>)</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the message is the specified signal </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04521">4521</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a85" doxytag="dbus-message.c::dbus_message_iter_append_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>array_iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>element_type</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends an array to the message and initializes an iterator that can be used to append to the array.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>array_iter</em> </td><td>
pointer to an iter that will be initialized </td></tr>
<tr><td valign=top><em>element_type</em> </td><td>
the type of the array elements </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03821">3821</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00140">DBusMessageRealIter::array_type_done</a>, <a class="el" href="dbus-message_8c-source.html#l00139">DBusMessageRealIter::array_type_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00134">DBusMessageRealIter::container_start</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a72" doxytag="dbus-message.c::dbus_message_iter_append_boolean"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_boolean </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a boolean value to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the boolean value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03486">3486</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a89" doxytag="dbus-message.c::dbus_message_iter_append_boolean_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_boolean_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned const char * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a boolean array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04117">4117</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a73" doxytag="dbus-message.c::dbus_message_iter_append_byte"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_byte </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned char </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a byte to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the byte value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03501">3501</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a95" doxytag="dbus-message.c::dbus_message_iter_append_byte_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_byte_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned const char * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a byte array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04226">4226</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a81" doxytag="dbus-message.c::dbus_message_iter_append_custom"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_custom </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>name</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const unsigned char * </td>
<td class="mdname" nowrap> <em>data</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a custom type data chunk to the message.
<p>
A custom type is simply an arbitrary UTF-8 string used as a type tag, plus an array of arbitrary bytes to be interpreted according to the type tag.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>name</em> </td><td>
the name of the type </td></tr>
<tr><td valign=top><em>data</em> </td><td>
the binary data used to store the value </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the binary data in bytes </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03660">3660</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a86" doxytag="dbus-message.c::dbus_message_iter_append_dict"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_dict </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>dict_iter</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a dict to the message and initializes an iterator that can be used to append to the dict.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>dict_iter</em> </td><td>
pointer to an iter that will be initialized </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03882">3882</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00134">DBusMessageRealIter::container_start</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a82" doxytag="dbus-message.c::dbus_message_iter_append_dict_key"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_dict_key </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a dict key name to the message.
<p>
The iterator used must point to a dict.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the string </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03699">3699</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a78" doxytag="dbus-message.c::dbus_message_iter_append_double"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_double </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>double </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a double value to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the double value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03579">3579</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a94" doxytag="dbus-message.c::dbus_message_iter_append_double_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_double_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const double * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a double array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04209">4209</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a74" doxytag="dbus-message.c::dbus_message_iter_append_int32"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_int32 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 32 bit signed integer to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the integer value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03515">3515</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a90" doxytag="dbus-message.c::dbus_message_iter_append_int32_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_int32_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 32 bit signed integer array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04134">4134</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a76" doxytag="dbus-message.c::dbus_message_iter_append_int64"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_int64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 64 bit signed integer to the message.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the integer value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03547">3547</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a92" doxytag="dbus-message.c::dbus_message_iter_append_int64_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_int64_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 64 bit signed integer array to the message.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04172">4172</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a70" doxytag="dbus-message.c::dbus_message_iter_append_nil"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_nil </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a nil value to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03439">3439</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a80" doxytag="dbus-message.c::dbus_message_iter_append_object_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_object_path </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends an object path to the message.
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000034">Todo: </a></b><dd>
add return_val_if_fail(UTF-8 is valid)</dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the object path </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03626">3626</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a97" doxytag="dbus-message.c::dbus_message_iter_append_object_path_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_object_path_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends an object path array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04274">4274</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a79" doxytag="dbus-message.c::dbus_message_iter_append_string"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_string </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a UTF-8 string to the message.
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000033">Todo: </a></b><dd>
add return_val_if_fail(UTF-8 is valid)</dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the string </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03595">3595</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a96" doxytag="dbus-message.c::dbus_message_iter_append_string_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_string_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a string array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04243">4243</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a75" doxytag="dbus-message.c::dbus_message_iter_append_uint32"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_uint32 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 32 bit unsigned integer to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the integer value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03529">3529</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a91" doxytag="dbus-message.c::dbus_message_iter_append_uint32_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_uint32_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 32 bit unsigned integer array to the message.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04151">4151</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a77" doxytag="dbus-message.c::dbus_message_iter_append_uint64"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_uint64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> </td>
<td class="mdname" nowrap> <em>value</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 64 bit unsigned integer to the message.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the integer value </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03563">3563</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a93" doxytag="dbus-message.c::dbus_message_iter_append_uint64_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_append_uint64_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> * </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Appends a 64 bit unsigned integer array to the message.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
an iterator pointing to the end of the message </td></tr>
<tr><td valign=top><em>value</em> </td><td>
the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
the length of the array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04191">4191</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a37" doxytag="dbus-message.c::dbus_message_iter_get_arg_type"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int dbus_message_iter_get_arg_type </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the argument type of the argument that the message iterator points at.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the field type </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02341">2341</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a30" doxytag="dbus-message.c::dbus_message_iter_get_args"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_args </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>... </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets arguments from a message iterator given a variable argument list.
<p>
The variable argument list should contain the type of the argumen followed by a pointer to where the value should be stored. The list is terminated with 0.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iterator </td></tr>
<tr><td valign=top><em>error</em> </td><td>
error to be filled in on failure </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
the first argument type </td></tr>
<tr><td valign=top><em>...</em> </td><td>
location for first argument value, then list of type-location pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if the error was set </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02121">2121</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a44" doxytag="dbus-message.c::dbus_message_iter_get_args_valist"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_args_valist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>first_arg_type</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>va_list </td>
<td class="mdname" nowrap> <em>var_args</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
This function takes a va_list for use by language bindings.
<p>
This function supports DBUS_TYPE_INT64 and DBUS_TYPE_UINT64 only if DBUS_HAVE_INT64 is defined.
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000032">Todo: </a></b><dd>
this function (or some lower-level non-convenience function) needs better error handling; should allow the application to distinguish between out of memory, and bad data from the remote app. It also needs to not leak a bunch of args when it gets to the arg that's bad, as that would be a security hole (allow one app to force another to leak memory)
<p>
We need to free the argument data when an error occurs.</dl>
<p>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a41">dbus_message_get_args</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
<tr><td valign=top><em>error</em> </td><td>
error to be filled in </td></tr>
<tr><td valign=top><em>first_arg_type</em> </td><td>
type of the first argument </td></tr>
<tr><td valign=top><em>var_args</em> </td><td>
return location for first argument, followed by list of type/location pairs </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if error was set </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02572">2572</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a39" doxytag="dbus-message.c::dbus_message_iter_get_array_type"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int dbus_message_iter_get_array_type </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the element type of the array that the message iterator points at.
<p>
Note that you need to check that the iterator points to an array prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the field type </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02414">2414</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a46" doxytag="dbus-message.c::dbus_message_iter_get_boolean"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_boolean </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the boolean value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a boolean value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the boolean value </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02812">2812</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a56" doxytag="dbus-message.c::dbus_message_iter_get_boolean_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_boolean_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned char ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the boolean array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03076">3076</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a45" doxytag="dbus-message.c::dbus_message_iter_get_byte"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> unsigned char dbus_message_iter_get_byte </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the byte value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a byte value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the byte value </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02793">2793</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a55" doxytag="dbus-message.c::dbus_message_iter_get_byte_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_byte_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned char ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the byte array that the iterator may point to.
<p>
Note that you need to check that the iterator points to a byte array prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for array values </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for length of byte array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03057">3057</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a42" doxytag="dbus-message.c::dbus_message_iter_get_custom"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_custom </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>char ** </td>
<td class="mdname" nowrap> <em>name</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned char ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the name and data from a custom type that an iterator may point to.
<p>
Note that you need to check that the iterator points to a custom type before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
<tr><td valign=top><em>name</em> </td><td>
return location for the name of the custom type </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for data </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for length of data </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
TRUE if get succeed </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02495">2495</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, and <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>. </td>
</tr>
</table>
<a name="a64" doxytag="dbus-message.c::dbus_message_iter_get_dict_key"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> char* dbus_message_iter_get_dict_key </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the key name fot the dict entry that an iterator may point to.
<p>
Note that you need to check that the iterator points to a dict entry before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a62">dbus_message_iter_init_dict_iterator</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the key name </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03275">3275</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, and <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>. </td>
</tr>
</table>
<a name="a51" doxytag="dbus-message.c::dbus_message_iter_get_double"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> double dbus_message_iter_get_double </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the double value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a string value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the double </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02915">2915</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a61" doxytag="dbus-message.c::dbus_message_iter_get_double_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_double_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>double ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the double array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03179">3179</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a47" doxytag="dbus-message.c::dbus_message_iter_get_int32"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> dbus_message_iter_get_int32 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 32 bit signed integer value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a 32-bit integer value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the integer </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02831">2831</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a57" doxytag="dbus-message.c::dbus_message_iter_get_int32_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_int32_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a4">dbus_int32_t</a> ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 32 bit signed integer array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03095">3095</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a49" doxytag="dbus-message.c::dbus_message_iter_get_int64"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> dbus_message_iter_get_int64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 64 bit signed integer value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a 64-bit integer value before using this function.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the integer </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02873">2873</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a59" doxytag="dbus-message.c::dbus_message_iter_get_int64_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_int64_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a8">dbus_int64_t</a> ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 64 bit signed integer array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03137">3137</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a41" doxytag="dbus-message.c::dbus_message_iter_get_object_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> char* dbus_message_iter_get_object_path </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the object path value that an iterator may point to.
<p>
Note that you need to check that the iterator points to an object path value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the path </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02466">2466</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, and <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>. </td>
</tr>
</table>
<a name="a63" doxytag="dbus-message.c::dbus_message_iter_get_object_path_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_object_path_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>char *** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the object path array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an object path array prior to using this function.
<p>
The returned value is a <a class="el" href="group__DBusMacros.html#a4">NULL</a>-terminated array of strings. Each string is a separate malloc block, and the array itself is a malloc block. You can free this type of array with <a class="el" href="group__DBusMemory.html#a4">dbus_free_string_array</a>().<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for string values </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for length of byte array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03242">3242</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, and <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>. </td>
</tr>
</table>
<a name="a40" doxytag="dbus-message.c::dbus_message_iter_get_string"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> char* dbus_message_iter_get_string </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the string value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a string value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the string </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02442">2442</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, and <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>. </td>
</tr>
</table>
<a name="a62" doxytag="dbus-message.c::dbus_message_iter_get_string_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_string_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>char *** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the string array that the iterator may point to.
<p>
Note that you need to check that the iterator points to a string array prior to using this function.
<p>
The returned value is a <a class="el" href="group__DBusMacros.html#a4">NULL</a>-terminated array of strings. Each string is a separate malloc block, and the array itself is a malloc block. You can free this type of string array with <a class="el" href="group__DBusMemory.html#a4">dbus_free_string_array</a>().<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for string values </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for length of byte array </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03203">3203</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, and <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>. </td>
</tr>
</table>
<a name="a48" doxytag="dbus-message.c::dbus_message_iter_get_uint32"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> dbus_message_iter_get_uint32 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 32 bit unsigned integer value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a 32-bit unsigned integer value before using this function.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the integer </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02850">2850</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a58" doxytag="dbus-message.c::dbus_message_iter_get_uint32_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_uint32_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a3">dbus_uint32_t</a> ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 32 bit unsigned integer array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03114">3114</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a50" doxytag="dbus-message.c::dbus_message_iter_get_uint64"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> dbus_message_iter_get_uint64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 64 bit unsigned integer value that an iterator may point to.
<p>
Note that you need to check that the iterator points to a 64-bit unsigned integer value before using this function.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a48">dbus_message_iter_get_arg_type</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the integer </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02894">2894</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a60" doxytag="dbus-message.c::dbus_message_iter_get_uint64_array"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_get_uint64_array </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a7">dbus_uint64_t</a> ** </td>
<td class="mdname" nowrap> <em>value</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the 64 bit unsigned integer array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array of the correct type prior to using this function.
<p>
This function only exists if DBUS_HAVE_INT64 is defined.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>value</em> </td><td>
return location for the array </td></tr>
<tr><td valign=top><em>len</em> </td><td>
return location for the array length </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l03158">3158</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a35" doxytag="dbus-message.c::dbus_message_iter_has_next"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_has_next </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Checks if an iterator has any more fields.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if there are more fields following </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02279">2279</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a31" doxytag="dbus-message.c::dbus_message_iter_init"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_init </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Initializes a <a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> representing the arguments of the message passed in.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>iter</em> </td><td>
pointer to an iterator to initialize </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if the message has no arguments </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02148">2148</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00139">DBusMessageRealIter::array_type_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00134">DBusMessageRealIter::container_start</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a52" doxytag="dbus-message.c::dbus_message_iter_init_array_iterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_init_array_iterator </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>array_iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int * </td>
<td class="mdname" nowrap> <em>array_type</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Initializes an iterator for the array that the iterator may point to.
<p>
Note that you need to check that the iterator points to an array prior to using this function.
<p>
The array element type is returned in array_type, and the array iterator can only be used to get that type of data.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>array_iter</em> </td><td>
pointer to an iterator to initialize </td></tr>
<tr><td valign=top><em>array_type</em> </td><td>
gets set to the type of the array elements </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if the array is empty </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02938">2938</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00140">DBusMessageRealIter::array_type_done</a>, <a class="el" href="dbus-message_8c-source.html#l00139">DBusMessageRealIter::array_type_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00134">DBusMessageRealIter::container_start</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a53" doxytag="dbus-message.c::dbus_message_iter_init_dict_iterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_init_dict_iterator </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>iter</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname" nowrap> <em>dict_iter</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Initializes an iterator for the dict that the iterator may point to.
<p>
Note that you need to check that the iterator points to a dict prior to using this function.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
the iterator </td></tr>
<tr><td valign=top><em>dict_iter</em> </td><td>
pointer to an iterator to initialize </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if the dict is empty </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02990">2990</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00127">DBusMessageRealIter::changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00102">changed_stamp</a>, <a class="el" href="dbus-message_8c-source.html#l00135">DBusMessageRealIter::container_length_pos</a>, <a class="el" href="dbus-message_8c-source.html#l00134">DBusMessageRealIter::container_start</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, <a class="el" href="dbus-message_8c-source.html#l00125">DBusMessageRealIter::parent_iter</a>, <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>, <a class="el" href="dbus-message_8c-source.html#l00130">DBusMessageRealIter::type</a>, and <a class="el" href="dbus-message_8c-source.html#l00137">DBusMessageRealIter::wrote_dict_key</a>. </td>
</tr>
</table>
<a name="a36" doxytag="dbus-message.c::dbus_message_iter_next"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_iter_next </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessageIter.html">DBusMessageIter</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>iter</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Moves the iterator to the next field.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>iter</em> </td><td>
The message iter </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the iterator was moved to the next field </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l02310">2310</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00097">byte_order</a>, <a class="el" href="dbus-message_8c-source.html#l00133">DBusMessageRealIter::end</a>, <a class="el" href="dbus-message_8c-source.html#l00126">DBusMessageRealIter::message</a>, and <a class="el" href="dbus-message_8c-source.html#l00132">DBusMessageRealIter::pos</a>. </td>
</tr>
</table>
<a name="a5" doxytag="dbus-message.c::dbus_message_new"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">int </td>
<td class="mdname1" valign="top" nowrap> <em>message_type</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Constructs a new message of the given message type.
<p>
Types include DBUS_MESSAGE_TYPE_METHOD_CALL, DBUS_MESSAGE_TYPE_SIGNAL, and so forth.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message_type</em> </td><td>
type of message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
new message or <a class="el" href="group__DBusMacros.html#a4">NULL</a> If no memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01383">1383</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a9" doxytag="dbus-message.c::dbus_message_new_error"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new_error </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>reply_to</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_name</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_message</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a new message that is an error reply to a certain message.
<p>
Error replies are possible in response to method calls primarily.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>reply_to</em> </td><td>
the original message </td></tr>
<tr><td valign=top><em>error_name</em> </td><td>
the error name </td></tr>
<tr><td valign=top><em>error_message</em> </td><td>
the error message string or <a class="el" href="group__DBusMacros.html#a4">NULL</a> for none </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
a new error message </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01544">1544</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a10" doxytag="dbus-message.c::dbus_message_new_error_printf"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new_error_printf </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>reply_to</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_name</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_format</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>... </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a new message that is an error reply to a certain message.
<p>
Error replies are possible in response to method calls primarily.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>reply_to</em> </td><td>
the original message </td></tr>
<tr><td valign=top><em>error_name</em> </td><td>
the error name </td></tr>
<tr><td valign=top><em>error_format</em> </td><td>
the error message string to be printed </td></tr>
<tr><td valign=top><em>...</em> </td><td>
value of first argument, list of additional values to print </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
a new error message </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01609">1609</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a6" doxytag="dbus-message.c::dbus_message_new_method_call"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new_method_call </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>service</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>path</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>interface</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>method</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Constructs a new message to invoke a method on a remote object.
<p>
Returns <a class="el" href="group__DBusMacros.html#a4">NULL</a> if memory can't be allocated for the message. The service may be <a class="el" href="group__DBusMacros.html#a4">NULL</a> in which case no service is set; this is appropriate when using D-BUS in a peer-to-peer context (no message bus). The interface may be <a class="el" href="group__DBusMacros.html#a4">NULL</a>, which means that if multiple methods with the given name exist it is undefined which one will be invoked.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>service</em> </td><td>
service that the message should be sent to or <a class="el" href="group__DBusMacros.html#a4">NULL</a> </td></tr>
<tr><td valign=top><em>path</em> </td><td>
object path the message should be sent to </td></tr>
<tr><td valign=top><em>interface</em> </td><td>
interface to invoke method on </td></tr>
<tr><td valign=top><em>method</em> </td><td>
method to invoke</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
a new <a class="el" href="structDBusMessage.html">DBusMessage</a>, free with <a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01422">1422</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a7" doxytag="dbus-message.c::dbus_message_new_method_return"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new_method_return </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>method_call</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Constructs a message that is a reply to a method call.
<p>
Returns <a class="el" href="group__DBusMacros.html#a4">NULL</a> if memory can't be allocated for the message.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>method_call</em> </td><td>
the message which the created message is a reply to. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
a new <a class="el" href="structDBusMessage.html">DBusMessage</a>, free with <a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a6">dbus_message_new_method_call</a>(), <a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01457">1457</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a8" doxytag="dbus-message.c::dbus_message_new_signal"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_new_signal </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>path</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>interface</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>name</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Constructs a new message representing a signal emission.
<p>
Returns <a class="el" href="group__DBusMacros.html#a4">NULL</a> if memory can't be allocated for the message. A signal is identified by its originating interface, and the name of the signal.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>path</em> </td><td>
the path to the object emitting the signal </td></tr>
<tr><td valign=top><em>interface</em> </td><td>
the interface the signal is emitted from </td></tr>
<tr><td valign=top><em>name</em> </td><td>
name of the signal </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
a new <a class="el" href="structDBusMessage.html">DBusMessage</a>, free with <a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a14">dbus_message_unref</a>() </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01507">1507</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<a name="a12" doxytag="dbus-message.c::dbus_message_ref"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusMessage.html">DBusMessage</a>* dbus_message_ref </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Increments the reference count of a <a class="el" href="structDBusMessage.html">DBusMessage</a>.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
The message </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the message </dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a10">dbus_message_unref</a> </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01714">1714</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00079">refcount</a>. </td>
</tr>
</table>
<a name="a101" doxytag="dbus-message.c::dbus_message_set_auto_activation"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void dbus_message_set_auto_activation </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td>
<td class="mdname" nowrap> <em>auto_activation</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets a flag indicating that the addressed service will be auto-activated before the message is delivered.
<p>
When this flag is set, the message is held until the service is succesfully activated or fail to activate. In case of failure, the reply will be an activation error.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>auto_activation</em> </td><td>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if auto-activation is desired </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04373">4373</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00081">header</a>, and <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a25" doxytag="dbus-message.c::dbus_message_set_destination"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_destination </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>destination</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the message's destination service.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>destination</em> </td><td>
the destination service name or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01985">1985</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a23" doxytag="dbus-message.c::dbus_message_set_error_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_error_name </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>error_name</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the name of the error (DBUS_MESSAGE_TYPE_ERROR).
<p>
The name is fully-qualified (namespaced).<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>error_name</em> </td><td>
the name or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01948">1948</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a19" doxytag="dbus-message.c::dbus_message_set_interface"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_interface </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>interface</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the interface this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or the interface a signal is being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>interface</em> </td><td>
the interface or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01869">1869</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a21" doxytag="dbus-message.c::dbus_message_set_member"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_member </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>member</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the interface member being invoked (DBUS_MESSAGE_TYPE_METHOD_CALL) or emitted (DBUS_MESSAGE_TYPE_SIGNAL).
<p>
The interface name is fully-qualified (namespaced).<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>member</em> </td><td>
the member or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01909">1909</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a99" doxytag="dbus-message.c::dbus_message_set_no_reply"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void dbus_message_set_no_reply </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td>
<td class="mdname" nowrap> <em>no_reply</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets a flag indicating that the message does not want a reply; if this flag is set, the other end of the connection may (but is not required to) optimize by not sending method return or error replies.
<p>
If this flag is set, there is no way to know whether the message successfully arrived at the remote end.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>no_reply</em> </td><td>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if no reply is desired </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04327">4327</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00081">header</a>, and <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a16" doxytag="dbus-message.c::dbus_message_set_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_path </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>object_path</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or the one a signal is being emitted from (for DBUS_MESSAGE_TYPE_SIGNAL).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>object_path</em> </td><td>
the path or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01803">1803</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a98" doxytag="dbus-message.c::dbus_message_set_sender"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_message_set_sender </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>sender</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the message sender.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
the message </td></tr>
<tr><td valign=top><em>sender</em> </td><td>
the sender or <a class="el" href="group__DBusMacros.html#a4">NULL</a> to unset </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04304">4304</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00104">locked</a>. </td>
</tr>
</table>
<a name="a14" doxytag="dbus-message.c::dbus_message_unref"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void dbus_message_unref </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>message</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Decrements the reference count of a <a class="el" href="structDBusMessage.html">DBusMessage</a>.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>message</em> </td><td>
The message </td></tr>
</table>
</dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="group__DBusMessage.html#a9">dbus_message_ref</a> </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l01745">1745</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>.
<p>
References <a class="el" href="dbus-message_8c-source.html#l00095">body</a>, <a class="el" href="dbus-message_8c-source.html#l00081">header</a>, <a class="el" href="dbus-message_8c-source.html#l00079">refcount</a>, <a class="el" href="dbus-message_8c-source.html#l00099">size_counters</a>, and <a class="el" href="dbus-message_8c-source.html#l00106">slot_list</a>. </td>
</tr>
</table>
<a name="a112" doxytag="dbus-message.c::dbus_set_error_from_message"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> dbus_set_error_from_message </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusMessage.html">DBusMessage</a> * </td>
<td class="mdname" nowrap> <em>message</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets a DBusError based on the contents of the given message.
<p>
The error is only set if the message is an error message, as in DBUS_MESSAGE_TYPE_ERROR. The name of the error is set to the name of the message, and the error message is set to the first argument if the argument exists and is a string.
<p>
The return value indicates whether the error was set (the error is set if and only if the message is an error message). So you can check for an error reply and convert it to <a class="el" href="structDBusError.html">DBusError</a> in one go.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>error</em> </td><td>
the error to set </td></tr>
<tr><td valign=top><em>message</em> </td><td>
the message to set it from </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if dbus_message_get_is_error() returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> for the message </dl>
<p>
Definition at line <a class="el" href="dbus-message_8c-source.html#l04667">4667</a> of file <a class="el" href="dbus-message_8c-source.html">dbus-message.c</a>. </td>
</tr>
</table>
<hr><address align="right"><small>Generated on Wed Jun 9 05:01:28 2004 for D-BUS by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0
width=110 height=53></a>1.2.15 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2007.0
>
x86_64
>
media
>
main-release
>
by-pkgid
>
926d2d1e3111287cee1b0a4fad4fb4f6
>
files
>
190
