comparison src/status.h @ 10337:682201b69107

[gaim-migrate @ 11545] * Preliminary reading of status.xml using xmlnode.[h|c] * I made a few changes the blist.xml readering code that I think makes it cleaner * "gaim_statuses_find_saved" makes more sense to me than "gaim_statuses_find_stored" * struct GaimStatus isn't really supposed to be used for keeping the saved statuses, is it? I don't see how that would work. It seems to make more sense to have a separate data structure for it. Maybe I'm not seeing things clearly. committer: Tailor Script <[e-mail]>

10336:114d3ac8ff5a

 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef _GAIM_STATUS_H_
#define _GAIM_STATUS_H_

typedef struct _GaimStatusType   GaimStatusType;
typedef struct _GaimStatusAttr   GaimStatusAttr;
typedef struct _GaimPresence     GaimPresence;
typedef struct _GaimStatus       GaimStatus;

/**
 * A context for a presence.
 *
 * The context indicates what the presence applies to.

gint gaim_presence_compare(const GaimPresence *presence1,
						   const GaimPresence *presence2);

/*@}*/


/**************************************************************************/
/** @name Status subsystem                                                */
/**************************************************************************/
/*@{*/

/**
 * Returns all stored statuses.
 *
 * @return A list of stored statuses.
 */
const GList *gaim_statuses_get_stored(void);

/**
 * Finds a stored status with the specified status type and primary ID.
 *
 * @param status_type The status type of the status.
 * @param id          The primary attribute ID.
 *
 * @return The stored status if found, or NULL.
 */
GaimStatus *gaim_statuses_find_stored(const GaimStatusType *status_type,
									  const char *id);

/**
 * Get the handle for the status subsystem.
 *
 * @return the handle to the status subsystem

10337:682201b69107

 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef _GAIM_STATUS_H_
#define _GAIM_STATUS_H_

typedef struct _GaimStatusType      GaimStatusType;
typedef struct _GaimStatusAttr      GaimStatusAttr;
typedef struct _GaimPresence        GaimPresence;
typedef struct _GaimStatus          GaimStatus;
typedef struct _GaimStatusSavedSub  GaimStatusSavedSub;
typedef struct _GaimStatusSaved     GaimStatusSaved;

/**
 * A context for a presence.
 *
 * The context indicates what the presence applies to.

gint gaim_presence_compare(const GaimPresence *presence1,
						   const GaimPresence *presence2);

/*@}*/

/**************************************************************************/
/** @name Status subsystem                                                */
/**************************************************************************/
/*@{*/

/**
 * Returns all saved statuses.
 *
 * @return A list of saved statuses.
 */
const GList *gaim_statuses_get_saved(void);

/**
 * Finds a saved status with the specified status type and primary ID.
 *
 * @param status_type The status type of the status.
 * @param id          The primary attribute ID.
 *
 * @return The saved status if found, or NULL.
 */
GaimStatusSaved *gaim_statuses_find_saved(const GaimStatusType *status_type,
										  const char *id);

/**
 * Return the name of a given saved status.
 *
 * @param saved_status The saved status.
 *
 * @return The name.
 */
const char *gaim_statuses_saved_get_name(const GaimStatusSaved *saved_status);

/**
 * Get the handle for the status subsystem.
 *
 * @return the handle to the status subsystem