comparison libpurple/conversation.h @ 32165:47f7b8ca6149

conversation: O(1) purple_conv_chat_cb_find I also deprecated what seems like a useless function. The ui_data is to implement constant-time lookups for the room list in Pidgin.

32164:bb77a9ceca17

 */
struct _PurpleConvChat
{
	PurpleConversation *conv;          /**< The parent conversation.      */

	GList *in_room;                  /**< The users in the room.        */
	GList *ignored;                  /**< Ignored users.                */
	char  *who;                      /**< The person who set the topic. */
	char  *topic;                    /**< The topic.                    */
	int    id;                       /**< The chat ID.                  */
	char *nick;                      /**< Your nick in this chat.       */

	gboolean left;                   /**< We left the chat and kept the window open */
};

/**
 * Data for "Chat Buddies"
 */

	                                  *   such as whether they are a channel operator.
	                                  */
	GHashTable *attributes;          /**< A hash table of attributes about the user, such as
                                    *   real name, user@host, etc.
                                    */
};

/**
 * Description of a conversation message
 *

 *
 * @param chat  The chat.
 * @param users The list of users.
 *
 * @return The list passed.
 */
GList *purple_conv_chat_set_users(PurpleConvChat *chat, GList *users);

/**
 * Returns a list of users in the chat room.  The members of the list

32165:47f7b8ca6149

 */
struct _PurpleConvChat
{
	PurpleConversation *conv;          /**< The parent conversation.      */

	GList *in_room;                  /**< The users in the room.
	                                  *   @deprecated Will be removed in 3.0.0
									  */
	GList *ignored;                  /**< Ignored users.                */
	char  *who;                      /**< The person who set the topic. */
	char  *topic;                    /**< The topic.                    */
	int    id;                       /**< The chat ID.                  */
	char *nick;                      /**< Your nick in this chat.       */

	gboolean left;                   /**< We left the chat and kept the window open */
	GHashTable *users;               /**< Hash table of the users in the room.
	                                  *   @since 2.9.0
	                                  */
	GHashFunc user_hash_func;        /**< Function used to hash entries into
	                                  *   the users hash. Defaults to a
	                                  *   case-insensitive collation function.
	                                  *   @since 2.9.0
	                                  */
	GEqualFunc user_eq_func;         /**< Function used for equality in the
	                                  *   users hash.  Defaults to a wrapper
	                                  *   around purple_utf8_strcasecmp.
	                                  *   @since 2.9.0
	                                  */
};

/**
 * Data for "Chat Buddies"
 */

	                                  *   such as whether they are a channel operator.
	                                  */
	GHashTable *attributes;          /**< A hash table of attributes about the user, such as
                                    *   real name, user@host, etc.
                                    */
	gpointer ui_data;                /** < The UI can put whatever it wants here. */
};

/**
 * Description of a conversation message
 *

 *
 * @param chat  The chat.
 * @param users The list of users.
 *
 * @return The list passed.
 *
 * @deprecated This function will be removed in 3.0.0.  You shouldn't be using it anyway.
 */
GList *purple_conv_chat_set_users(PurpleConvChat *chat, GList *users);

/**
 * Returns a list of users in the chat room.  The members of the list