From 24f1fb252aeb0c725bc709191d061069d00b96b1 Mon Sep 17 00:00:00 2001 From: Niels De Graef Date: Sun, 4 Nov 2018 18:54:44 +0100 Subject: [PATCH] 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 --- gst/gstmessage.h | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/gst/gstmessage.h b/gst/gstmessage.h index 84c16ba770..ba5e4e9339 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: