Method

PurpleConversationManagerfind

since: 3.0

Declaration [src]

PurpleConversation*
purple_conversation_manager_find (
  PurpleConversationManager* manager,
  PurpleAccount* account,
  const gchar* name
)

Description [src]

Looks for a registered conversation belonging to account and named named. This function will return the first one matching the given criteria. If you specifically need an im or chat see purple_conversation_manager_find_im() or purple_conversation_manager_find_chat().

Available since: 3.0

Parameters

account

Type: PurpleAccount

The PurpleAccount instance whose conversation to find.

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

Type: const gchar*

The name of the conversation.

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

Return value

Type: PurpleConversation

The PurpleConversation if found, otherwise NULL.

The data is owned by the instance.