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 beNULL
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.