API: add GST_MESSAGE_SRC_NAME macro

Add GST_MESSAGE_SRC_NAME macro that always returns a non-NULL string.
Useful for debugging and logging purposes.

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index 790b0b9..448eff7 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -1092,6 +1092,7 @@ gst_iterator_result_get_type
 GstMessage
 GstMessageType
 GST_MESSAGE_SRC
+GST_MESSAGE_SRC_NAME
 GST_MESSAGE_TIMESTAMP
 GST_MESSAGE_TYPE
 GST_MESSAGE_TYPE_NAME

diff --git a/gst/gstmessage.h b/gst/gstmessage.h
index 48339b4..12284a9 100644 (file)
--- a/gst/gstmessage.h
+++ b/gst/gstmessage.h
@@ -182,6 +182,17 @@ typedef enum
  * Get the object that posted @message.
  */
 #define GST_MESSAGE_SRC(message)       (GST_MESSAGE(message)->src)
+/**
+ * GST_MESSAGE_SRC_NAME:
+ * @message: a #GstMessage
+ *
+ * Get the name of the object that posted @message. Returns "(NULL)" if
+ * the message has no source object set.
+ *
+ * Since: 0.10.24
+ */
+#define GST_MESSAGE_SRC_NAME(message)  (GST_MESSAGE_SRC(message) ? \
+    GST_OBJECT_NAME (GST_MESSAGE_SRC(message)) : "(NULL)")
 
 /**
  * GstStructureChangeType: