Function

Purpleblist_find_buddies

Declaration [src] 

GSList*
purple_blist_find_buddies (
  PurpleAccount* account,
  const char* name
)

Description [src]

Finds all PurpleBuddy structs given a name and an account.

Parameters

account

Type: PurpleAccount

The account this buddy belongs to.

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

Type: const char*

The buddy’s name (or NULL to return all buddies for the account)

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

Return value

Type: A list of None

NULL if the buddy doesn’t exist, or a GSList of PurpleBuddy structs.

The caller of the function takes ownership of the data container, but not the data inside it.