summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2007-10-09 17:34:09 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2007-10-11 10:35:25 +0100
commit262c02a9facebc8592fa60406d8971b1837725f5 (patch)
tree872cf23811677ae84a1d6a9ba22ac5e27d7d8fd5
parent559de12aac424aa726007abb5cf6a7ac12d39db4 (diff)
Add DBUS_ERROR_INITIALIZER macro
-rw-r--r--dbus/dbus-errors.c24
-rw-r--r--dbus/dbus-errors.h2
2 files changed, 25 insertions, 1 deletions
diff --git a/dbus/dbus-errors.c b/dbus/dbus-errors.c
index d0a80b02..30bf6a1f 100644
--- a/dbus/dbus-errors.c
+++ b/dbus/dbus-errors.c
@@ -34,7 +34,29 @@
* @brief Error reporting internals
* @{
*/
-
+
+/**
+ * @def DBUS_ERROR_INITIALIZER
+ *
+ * Expands to a suitable initializer for a DBusError on the stack.
+ * Declaring a DBusError with:
+ *
+ * @code
+ * DBusError error = DBUS_ERROR_INITIALIZER;
+ *
+ * do_things_with (&error);
+ * @endcode
+ *
+ * is a more concise form of:
+ *
+ * @code
+ * DBusError error;
+ *
+ * dbus_error_init (&error);
+ * do_things_with (&error);
+ * @endcode
+ */
+
/**
* Internals of DBusError
*/
diff --git a/dbus/dbus-errors.h b/dbus/dbus-errors.h
index e01818c4..ee170071 100644
--- a/dbus/dbus-errors.h
+++ b/dbus/dbus-errors.h
@@ -58,6 +58,8 @@ struct DBusError
void *padding1; /**< placeholder */
};
+#define DBUS_ERROR_INITIALIZER { NULL, NULL, 0, 0, 0, 0, 0, NULL }
+
void dbus_error_init (DBusError *error);
void dbus_error_free (DBusError *error);
void dbus_set_error (DBusError *error,