Method

PurpleConversationManagerfind

unstable since: 3.0

Declaration [src]

PurpleConversation*
purple_conversation_manager_find (
  PurpleConversationManager* manager,
  PurpleAccount* account,
  PurpleConversationType conversation_type,
  const char* id
)

Description [src]

Looks for a conversation based on the its id, type, and account it belongs to.

Available since: 3.0

Parameters

account

Type: PurpleAccount

The account.

The data is owned by the caller of the method.
conversation_type

Type: PurpleConversationType

The conversation type.

id

Type: const char*

The identifier.

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

Return value

Type: PurpleConversation

The PurpleConversation if found.

The returned data is owned by the instance.
The return value can be NULL.