taglist: add gst_clear_tag_list()
authorNiels De Graef <nielsdegraef@gmail.com>
Sun, 4 Nov 2018 17:55:42 +0000 (18:55 +0100)
committerSebastian Dröge <slomo@coaxion.net>
Mon, 5 Nov 2018 11:06:30 +0000 (11:06 +0000)
Basically, you can use this instead of using gst_tag_list_unref (which
needs to be preceded by a NULL-check).

Also fixes #275

gst/gsttaglist.h

index 0466183..cae4978 100644 (file)
@@ -482,6 +482,25 @@ gst_tag_list_unref (GstTagList * taglist)
 }
 
 /**
+ * gst_clear_tag_list: (skip)
+ * @taglist_ptr: a pointer to a #GstTagList reference
+ *
+ * Clears a reference to a #GstTagList.
+ *
+ * @taglist_ptr must not be %NULL.
+ *
+ * If the reference is %NULL then this function does nothing. Otherwise, the
+ * reference count of the taglist is decreased and the pointer is set to %NULL.
+ *
+ * Since: 1.16
+ */
+static inline void
+gst_clear_tag_list (GstTagList ** taglist_ptr)
+{
+  gst_clear_mini_object (taglist_ptr);
+}
+
+/**
  * gst_tag_list_copy:
  * @taglist: a #GstTagList.
  *