Method

PurpleConversationMembersfind_or_add_member

unstable since: 3.0

Declaration [src]

PurpleConversationMember*
purple_conversation_members_find_or_add_member (
  PurpleConversationMembers* members,
  PurpleContactInfo* info,
  gboolean announce,
  const char* message
)

Description [src]

Finds or adds a member to a conversation.

If info is not a member of the conversation, purple_conversation_members_add_member() will be called with the given parameters.

Available since: 3.0

Parameters

info

Type: PurpleContactInfo

The contact info to find or add.

The data is owned by the caller of the method.

announce

Type: gboolean

If true the user interface should tell the user about this member being added.

message

Type: const char*

The message to use if announcing.

The data is owned by the caller of the method.

The value is a NUL terminated UTF-8 string.

Return value

Type: PurpleConversationMember

The conversation member.

The returned data is owned by the instance.