Method

PurpleTagslookup

Declaration [src]

const gchar*
purple_tags_lookup (
  PurpleTags* tags,
  const gchar* 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.0

Parameters

name const gchar*
 

The name of the tag to check if it exists.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
found 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.

Return value

Returns: const gchar*
 

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

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