Method

PurpleChatConversationadd_users

since: 3.0

Declaration [src]

void
purple_chat_conversation_add_users (
  PurpleChatConversation* chat,
  GList* users,
  GList* extra_msgs,
  GList* flags,
  gboolean new_arrivals
)

Description [src]

Adds a list of users to a chat.

The data is copied from users, extra_msgs, and flags, so it is up to the caller to free this list after calling this function.

Available since: 3.0

Parameters

users

Type: A list of utf8

The list of users to add.

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

Type: A list of utf8

An extra message to display with the join message for each user. This list may be shorter than users, in which case, the users after the end of extra_msgs will not have an extra message. By extension, this means that extra_msgs can simply be NULL and none of the users will have an extra message.

The argument can be NULL.
The data is owned by the caller of the function.
Each element is a NUL terminated UTF-8 string.
flags

Type: A list of PurpleChatUserFlags

The list of flags for each user. This list data should be an int converted to pointer using GINT_TO_POINTER(flag)

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

Type: gboolean

Decides whether or not to show join notices.