Method

PurpleTagslookup

unstable since: 3.0

Declaration [src] 

const char*
purple_tags_lookup (
  PurpleTags* tags,
  const char* name,
  gboolean* found
)

Description [src]

Gets the value of name if it exists in tags.

If found is non NULL, it will be set to TRUE if name was found.

Available since: 3.0

Parameters

name

Type: const char*

The name of the tag to check if it exists.

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

Type: gboolean*

A return address for a boolean on whether the tag was found or not.

The argument will be set by the function.
The argument can be set to NULL by the method.

Return value

Type: const char*

The value of the first tag matching name. If there is no value, NULL is returned.

The returned data is owned by the instance.
The value is a NUL terminated UTF-8 string.