caps: add gst_clear_caps()

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

Also fixes #275
This commit is contained in:
Niels De Graef 2018-11-04 18:53:31 +01:00 committed by Sebastian Dröge
parent fa1d7a86af
commit a0fd447abe

View file

@ -223,6 +223,25 @@ gst_caps_unref (GstCaps * caps)
gst_mini_object_unref (GST_MINI_OBJECT_CAST (caps));
}
/**
* gst_clear_caps: (skip)
* @caps_ptr: a pointer to a #GstCaps reference
*
* Clears a reference to a #GstCaps.
*
* @caps_ptr must not be %NULL.
*
* If the reference is %NULL then this function does nothing. Otherwise, the
* reference count of the caps is decreased and the pointer is set to %NULL.
*
* Since: 1.16
*/
static inline void
gst_clear_caps (GstCaps ** caps_ptr)
{
gst_clear_mini_object (caps_ptr);
}
/* copy caps */
GST_API
GstCaps * gst_caps_copy (const GstCaps * caps);