buffer: add gst_clear_buffer()

[platform/upstream/gstreamer.git] / gst / gstbuffer.h

diff --git a/gst/gstbuffer.h b/gst/gstbuffer.h
index 2804b52..1b62962 100644 (file)
--- a/gst/gstbuffer.h
+++ b/gst/gstbuffer.h
@@ -442,6 +442,25 @@ gst_buffer_unref (GstBuffer * buf)
   gst_mini_object_unref (GST_MINI_OBJECT_CAST (buf));
 }
 
+/**
+ * gst_clear_buffer: (skip)
+ * @buf_ptr: a pointer to a #GstBuffer reference
+ *
+ * Clears a reference to a #GstBuffer.
+ *
+ * @buf_ptr must not be %NULL.
+ *
+ * If the reference is %NULL then this function does nothing. Otherwise, the
+ * reference count of the buffer is decreased and the pointer is set to %NULL.
+ *
+ * Since: 1.16
+ */
+static inline void
+gst_clear_buffer (GstBuffer ** buf_ptr)
+{
+  gst_clear_mini_object (buf_ptr);
+}
+
 /* copy buffer */
 /**
  * gst_buffer_copy: