Method
PurpleContactManagerfind_or_create
Declaration [src]
PurpleContact*
purple_contact_manager_find_or_create (
PurpleContactManager* manager,
PurpleAccount* account,
const char* id,
gboolean* found
)
Description [src]
Looks for a PurpleContact that belongs to account with an id of id
or creates a new one.
Parameters
account-
Type:
PurpleAccountThe account whose contact to find.
The data is owned by the caller of the method. id-
Type:
const char*The id of the contact to find.
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 which will be set to true if the contact was found.
The argument will be set by the function. The argument can be NULL.
Return value
Type: PurpleContact
The PurpleContact that was either found or newly created.
| The caller of the method takes ownership of the returned data, and is responsible for freeing it. |