Function

PurpleBuddyicons_find

since: 2.0.0

Declaration [src]

PurpleBuddyIcon*
purple_buddy_icons_find (
  PurpleAccount* account,
  const char* username
)

Description [src]

Returns the buddy icon information for a user.

Available since: 2.0.0

Parameters

account

Type: PurpleAccount

The account the user is on.

The data is owned by the caller of the function.
username

Type: const char*

The username of the user.

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

Return value

Type: PurpleBuddyIcon

The icon (with a reference for the caller) if found, or NULL if not found.

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