TagList

---

Object Hierarchy:

Description:

Content:

Static methods:

• public static bool copy_value (out Value dest, TagList list, string tag)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. You must unset the value after use. given list.

Creation methods:

• public TagList ()
  Creates a new empty GstTagList.
• public TagList.full (string tag)
  Creates a new taglist and appends the values for the given tags. It expects tag-value pairs like add, and a NULL terminator after the last pair. The type of the values is implicit and is documented in the API reference, but can also be queried at runtime with tag_get_type. It is an error to pass a value of a type not matching the tag type into this function. The tag list will make copies of any arguments passed (e.g. strings, buffers). when no longer needed.
• public TagList.full_valist (void* var_args)
  Just like TagList.full, only that it takes a va_list argument. Useful mostly for language bindings. when no longer needed.

Methods:

• public void add (TagMergeMode mode, string tag, ...)
  Sets the values for the given tags using the specified mode.
• public void add_valist (TagMergeMode mode, string tag, void* var_args)
  Sets the values for the given tags using the specified mode.
• public void add_valist_values (TagMergeMode mode, string tag, void* var_args)
  Sets the GValues for the given tags using the specified mode.
• public void add_value (TagMergeMode mode, string tag, Value value)
  Sets the GValue for a given tag using the specified mode.
• public void add_values (TagMergeMode mode, string tag, ...)
  Sets the GValues for the given tags using the specified mode.
• public TagList copy ()
  Copies a given TagList.
• public void foreach (TagForeachFunc func)
  Calls the given function for each tag inside the tag list. Note that if there is no tag, the function won't be called at all.
• public bool get_boolean (string tag, out bool value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_boolean_index (string tag, uint index, out bool value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_buffer (string tag, out Buffer value)
  Copies the first buffer for the given tag in the taglist into the variable pointed to by value . Free the buffer with unref when it is no longer needed. given list or if it was null.
• public bool get_buffer_index (string tag, uint index, out Buffer value)
  Gets the buffer that is at the given index for the given tag in the given list and copies it into the variable pointed to by value. Free the buffer with unref when it is no longer needed. given list or if it was null.
• public bool get_char (string tag, out char value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_char_index (string tag, uint index, out char value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_date (string tag, out Date? value)
  Copies the first date for the given tag in the taglist into the variable pointed to by value . Free the date with g_date_free when it is no longer needed. given list or if it was null.
• public bool get_date_index (string tag, uint index, out Date? value)
  Gets the date that is at the given index for the given tag in the given list and copies it into the variable pointed to by value. Free the date with g_date_free when it is no longer needed. given list or if it was null.
• public bool get_date_time (string tag, out DateTime value)
  Copies the first datetime for the given tag in the taglist into the variable pointed to by value . Unref the date with gst_date_time_unref when it is no longer needed. thegiven list or if it was null .
• public bool get_date_time_index (string tag, uint index, out DateTime value)
  Gets the datetime that is at the given index for the given tag in the given list and copies it into the variable pointed to by value. Unref the datetime with gst_date_time_unref when it is no longer needed. given list or if it was null.
• public bool get_double (string tag, out double value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_double_index (string tag, uint index, out double value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_float (string tag, out float value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_float_index (string tag, uint index, out float value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_int (string tag, out int value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_int64 (string tag, out int64 value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_int64_index (string tag, uint index, out int64 value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_int_index (string tag, uint index, out int value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_long (string tag, out long value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_long_index (string tag, uint index, out long value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_pointer (string tag, out void* value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_pointer_index (string tag, uint index, out void* value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• 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. Since 0.10.24 the returned string is also guaranteed to be non-NULL and non-empty. given list.
• public bool get_string_index (string tag, uint index, out string value)
  Gets the value that is at the given index for the given tag in the given list. 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. Since 0.10.24 the returned string is also guaranteed to be non-NULL and non-empty. given list.
• public uint get_tag_size (string tag)
  Checks how many value are stored in this tag list for the given tag.
• public bool get_uchar (string tag, out uchar value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_uchar_index (string tag, uint index, out uchar value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_uint (string tag, out uint value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_uint64 (string tag, out uint64 value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_uint64_index (string tag, uint index, out uint64 value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_uint_index (string tag, uint index, out uint value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public bool get_ulong (string tag, out ulong value)
  Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. given list.
• public bool get_ulong_index (string tag, uint index, out ulong value)
  Gets the value that is at the given index for the given tag in the given list. given list.
• public unowned Value? get_value_index (string tag, uint index)
  Gets the value that is at the given index for the given tag in the given list. tag wasn't available or the tag doesn't have as many entries
• public void insert (TagList from, TagMergeMode mode)
  Inserts the tags of the from list into the first list using the given mode.
• public bool is_empty ()
  Checks if the given taglist is empty.
• public TagList merge (TagList list2, TagMergeMode mode)
  Merges the two given lists into a new list. If one of the lists is NULL, a copy of the other is returned. If both lists are NULL, NULL is returned.
• public bool peek_string_index (string tag, uint index, string value)
  Peeks at the value that is at the given index for the given tag in the given list. The resulting string in value will be in UTF-8 encoding and doesn't need to be freed by the caller. The returned string is also guaranteed to be non-NULL and non-empty. given list.
• public void remove_tag (string tag)
  Removes the given tag from the taglist.