get_string


Description:

public bool get_string (string tag, out string value)

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

Parameters:

this

a TagList to get the tag from

tag

tag to read out

value

location for the result

Returns:

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