Copies the contents for the given tag into the value, possibly merging multiple values into one if multiple values are associated with the tag.

Use gst_tag_list_get_string_index (list, tag, 0, value) if you want to retrieve the first string associated with this tag unmodified.

The resulting string in value will be in UTF-8 encoding and should be freed by the caller using g_free when no longer needed. The returned string is also guaranteed to be non-NULL and non-empty.

Free-function: g_free

class TagList
string tag
out string value


tag string

tag to read out

value string

location for the result

Return Value

Type: bool

TRUE, if a value was copied, FALSE if the tag didn't exist in the given list.