From: Niels De Graef <nielsdegraef@gmail.com>
Date: Sun, 4 Nov 2018 17:54:44 +0000 (+0100)
Subject: message: add gst_clear_message()
X-Git-Tag: 1.16.2~221
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=24f1fb252aeb0c725bc709191d061069d00b96b1;p=platform%2Fupstream%2Fgstreamer.git

message: add gst_clear_message()

Basically, you can use this instead of using gst_message_unref (which
needs to be preceded by a NULL-check).

Also fixes #275
---

diff --git a/gst/gstmessage.h b/gst/gstmessage.h
index 84c16ba..ba5e4e9 100644
--- a/gst/gstmessage.h
+++ b/gst/gstmessage.h
@@ -379,6 +379,25 @@ gst_message_unref (GstMessage * msg)
   gst_mini_object_unref (GST_MINI_OBJECT_CAST (msg));
 }
 
+/**
+ * gst_clear_message: (skip)
+ * @msg_ptr: a pointer to a #GstMessage reference
+ *
+ * Clears a reference to a #GstMessage.
+ *
+ * @msg_ptr must not be %NULL.
+ *
+ * If the reference is %NULL then this function does nothing. Otherwise, the
+ * reference count of the message is decreased and the pointer is set to %NULL.
+ *
+ * Since: 1.16
+ */
+static inline void
+gst_clear_message (GstMessage ** msg_ptr)
+{
+  gst_clear_mini_object (msg_ptr);
+}
+
 /* copy message */
 /**
  * gst_message_copy: