Method

PurpleTagsget_all_with_name

unstable since: 3.0

Declaration [src]

PurpleTags*
purple_tags_get_all_with_name (
  PurpleTags* tags,
  const char* name
)

Description [src]

Gets a a new tags object with all of the tags that are named name.

Note: This always returns a new tags object, even if no tags matched.

Available since: 3.0

Parameters

name

Type: const char*

The name of the tags to get.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.

Return value

Type: PurpleTags

A new tags object with all of the matching tags.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.