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 PurpleAccount
 

The account this buddy belongs to.

 The data is owned by the caller of the function.
name 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

Returns: 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.