gconf-value

gconf-value

Synopsis

enum                GConfValueType;
struct              GConfValue;
#define             GCONF_VALUE_TYPE_VALID              (x)
const char *        gconf_value_get_string              (const GConfValue *value);
int                 gconf_value_get_int                 (const GConfValue *value);
double              gconf_value_get_float               (const GConfValue *value);
GConfValueType      gconf_value_get_list_type           (const GConfValue *value);
GSList *            gconf_value_get_list                (const GConfValue *value);
GConfValue *        gconf_value_get_car                 (const GConfValue *value);
GConfValue *        gconf_value_get_cdr                 (const GConfValue *value);
gboolean            gconf_value_get_bool                (const GConfValue *value);
GConfSchema *       gconf_value_get_schema              (const GConfValue *value);
GConfValue *        gconf_value_new                     (GConfValueType type);
GConfValue *        gconf_value_new_from_string         (GConfValueType type,
                                                         const gchar *str,
                                                         GError **err);
GConfValue *        gconf_value_copy                    (const GConfValue *src);
void                gconf_value_free                    (GConfValue *value);
void                gconf_value_set_int                 (GConfValue *value,
                                                         gint the_int);
void                gconf_value_set_string              (GConfValue *value,
                                                         const gchar *the_str);
void                gconf_value_set_float               (GConfValue *value,
                                                         gdouble the_float);
void                gconf_value_set_bool                (GConfValue *value,
                                                         gboolean the_bool);
void                gconf_value_set_schema              (GConfValue *value,
                                                         const GConfSchema *sc);
void                gconf_value_set_schema_nocopy       (GConfValue *value,
                                                         GConfSchema *sc);
void                gconf_value_set_car                 (GConfValue *value,
                                                         const GConfValue *car);
void                gconf_value_set_car_nocopy          (GConfValue *value,
                                                         GConfValue *car);
void                gconf_value_set_cdr                 (GConfValue *value,
                                                         const GConfValue *cdr);
void                gconf_value_set_cdr_nocopy          (GConfValue *value,
                                                         GConfValue *cdr);
void                gconf_value_set_list_type           (GConfValue *value,
                                                         GConfValueType type);
void                gconf_value_set_list_nocopy         (GConfValue *value,
                                                         GSList *list);
void                gconf_value_set_list                (GConfValue *value,
                                                         GSList *list);
gchar *             gconf_value_to_string               (const GConfValue *value);
struct              GConfMetaInfo;
GConfMetaInfo *     gconf_meta_info_new                 (void);
void                gconf_meta_info_free                (GConfMetaInfo *gcmi);
const char *        gconf_meta_info_get_schema          (GConfMetaInfo *gcmi);
const char *        gconf_meta_info_get_mod_user        (GConfMetaInfo *gcmi);
GTime               gconf_meta_info_mod_time            (GConfMetaInfo *gcmi);
void                gconf_meta_info_set_schema          (GConfMetaInfo *gcmi,
                                                         const gchar *schema_name);
void                gconf_meta_info_set_mod_user        (GConfMetaInfo *gcmi,
                                                         const gchar *mod_user);
void                gconf_meta_info_set_mod_time        (GConfMetaInfo *gcmi,
                                                         GTime mod_time);
struct              GConfEntry;
const char *        gconf_entry_get_key                 (const GConfEntry *entry);
GConfValue *        gconf_entry_get_value               (const GConfEntry *entry);
const char *        gconf_entry_get_schema_name         (const GConfEntry *entry);
gboolean            gconf_entry_get_is_default          (const GConfEntry *entry);
gboolean            gconf_entry_get_is_writable         (const GConfEntry *entry);
GConfEntry *        gconf_entry_new                     (const gchar *key,
                                                         const GConfValue *val);
GConfEntry *        gconf_entry_new_nocopy              (gchar *key,
                                                         GConfValue *val);
GConfEntry *        gconf_entry_copy                    (const GConfEntry *src);
void                gconf_entry_free                    (GConfEntry *entry);
GConfEntry *        gconf_entry_ref                     (GConfEntry *entry);
void                gconf_entry_unref                   (GConfEntry *entry);
GConfValue *        gconf_entry_steal_value             (GConfEntry *entry);
void                gconf_entry_set_value               (GConfEntry *entry,
                                                         const GConfValue *val);
void                gconf_entry_set_value_nocopy        (GConfEntry *entry,
                                                         GConfValue *val);
void                gconf_entry_set_schema_name         (GConfEntry *entry,
                                                         const gchar *name);
void                gconf_entry_set_is_default          (GConfEntry *entry,
                                                         gboolean is_default);
void                gconf_entry_set_is_writable         (GConfEntry *entry,
                                                         gboolean is_writable);

Description

Details

enum GConfValueType

typedef enum {
  GCONF_VALUE_INVALID,
  GCONF_VALUE_STRING,
  GCONF_VALUE_INT,
  GCONF_VALUE_FLOAT,
  GCONF_VALUE_BOOL,
  GCONF_VALUE_SCHEMA,

  /* unfortunately these aren't really types; we want list_of_string,
     list_of_int, etc.  but it's just too complicated to implement.
     instead we'll complain in various places if you do something
     moronic like mix types in a list or treat pair<string,int> and
     pair<float,bool> as the same type. */
  GCONF_VALUE_LIST,
  GCONF_VALUE_PAIR
} GConfValueType;


struct GConfValue

struct GConfValue {
  GConfValueType type;
};


GCONF_VALUE_TYPE_VALID()

#define GCONF_VALUE_TYPE_VALID(x) (((x) > GCONF_VALUE_INVALID) && ((x) <= GCONF_VALUE_PAIR))


gconf_value_get_string ()

const char *        gconf_value_get_string              (const GConfValue *value);


gconf_value_get_int ()

int                 gconf_value_get_int                 (const GConfValue *value);


gconf_value_get_float ()

double              gconf_value_get_float               (const GConfValue *value);


gconf_value_get_list_type ()

GConfValueType      gconf_value_get_list_type           (const GConfValue *value);


gconf_value_get_list ()

GSList *            gconf_value_get_list                (const GConfValue *value);

Returns a GSList containing GConfValue objects. Each GConfValue in the returned list will have the type returned by gconf_value_get_list_type(). Remember that the empty GSList is equal to NULL. The list is not a copy; it is "owned" by the GConfValue and will be destroyed when the GConfValue is destroyed.

value :

a GConfValue.

Returns :

a GList. [element-type GConfValue][transfer none]

gconf_value_get_car ()

GConfValue *        gconf_value_get_car                 (const GConfValue *value);


gconf_value_get_cdr ()

GConfValue *        gconf_value_get_cdr                 (const GConfValue *value);


gconf_value_get_bool ()

gboolean            gconf_value_get_bool                (const GConfValue *value);


gconf_value_get_schema ()

GConfSchema *       gconf_value_get_schema              (const GConfValue *value);


gconf_value_new ()

GConfValue *        gconf_value_new                     (GConfValueType type);


gconf_value_new_from_string ()

GConfValue *        gconf_value_new_from_string         (GConfValueType type,
                                                         const gchar *str,
                                                         GError **err);


gconf_value_copy ()

GConfValue *        gconf_value_copy                    (const GConfValue *src);


gconf_value_free ()

void                gconf_value_free                    (GConfValue *value);


gconf_value_set_int ()

void                gconf_value_set_int                 (GConfValue *value,
                                                         gint the_int);


gconf_value_set_string ()

void                gconf_value_set_string              (GConfValue *value,
                                                         const gchar *the_str);


gconf_value_set_float ()

void                gconf_value_set_float               (GConfValue *value,
                                                         gdouble the_float);


gconf_value_set_bool ()

void                gconf_value_set_bool                (GConfValue *value,
                                                         gboolean the_bool);


gconf_value_set_schema ()

void                gconf_value_set_schema              (GConfValue *value,
                                                         const GConfSchema *sc);


gconf_value_set_schema_nocopy ()

void                gconf_value_set_schema_nocopy       (GConfValue *value,
                                                         GConfSchema *sc);


gconf_value_set_car ()

void                gconf_value_set_car                 (GConfValue *value,
                                                         const GConfValue *car);


gconf_value_set_car_nocopy ()

void                gconf_value_set_car_nocopy          (GConfValue *value,
                                                         GConfValue *car);


gconf_value_set_cdr ()

void                gconf_value_set_cdr                 (GConfValue *value,
                                                         const GConfValue *cdr);


gconf_value_set_cdr_nocopy ()

void                gconf_value_set_cdr_nocopy          (GConfValue *value,
                                                         GConfValue *cdr);


gconf_value_set_list_type ()

void                gconf_value_set_list_type           (GConfValue *value,
                                                         GConfValueType type);


gconf_value_set_list_nocopy ()

void                gconf_value_set_list_nocopy         (GConfValue *value,
                                                         GSList *list);


gconf_value_set_list ()

void                gconf_value_set_list                (GConfValue *value,
                                                         GSList *list);


gconf_value_to_string ()

gchar *             gconf_value_to_string               (const GConfValue *value);


struct GConfMetaInfo

struct GConfMetaInfo {
  gchar* schema;
  gchar* mod_user; /* user owning the daemon that made the last modification */
  GTime  mod_time; /* time of the modification */
};

gconf_meta_info_new ()

GConfMetaInfo *     gconf_meta_info_new                 (void);


gconf_meta_info_free ()

void                gconf_meta_info_free                (GConfMetaInfo *gcmi);


gconf_meta_info_get_schema ()

const char *        gconf_meta_info_get_schema          (GConfMetaInfo *gcmi);


gconf_meta_info_get_mod_user ()

const char *        gconf_meta_info_get_mod_user        (GConfMetaInfo *gcmi);


gconf_meta_info_mod_time ()

GTime               gconf_meta_info_mod_time            (GConfMetaInfo *gcmi);


gconf_meta_info_set_schema ()

void                gconf_meta_info_set_schema          (GConfMetaInfo *gcmi,
                                                         const gchar *schema_name);


gconf_meta_info_set_mod_user ()

void                gconf_meta_info_set_mod_user        (GConfMetaInfo *gcmi,
                                                         const gchar *mod_user);


gconf_meta_info_set_mod_time ()

void                gconf_meta_info_set_mod_time        (GConfMetaInfo *gcmi,
                                                         GTime mod_time);


struct GConfEntry

struct GConfEntry {
  char *key;
  GConfValue *value;
};


gconf_entry_get_key ()

const char *        gconf_entry_get_key                 (const GConfEntry *entry);


gconf_entry_get_value ()

GConfValue *        gconf_entry_get_value               (const GConfEntry *entry);


gconf_entry_get_schema_name ()

const char *        gconf_entry_get_schema_name         (const GConfEntry *entry);


gconf_entry_get_is_default ()

gboolean            gconf_entry_get_is_default          (const GConfEntry *entry);


gconf_entry_get_is_writable ()

gboolean            gconf_entry_get_is_writable         (const GConfEntry *entry);


gconf_entry_new ()

GConfEntry *        gconf_entry_new                     (const gchar *key,
                                                         const GConfValue *val);


gconf_entry_new_nocopy ()

GConfEntry *        gconf_entry_new_nocopy              (gchar *key,
                                                         GConfValue *val);


gconf_entry_copy ()

GConfEntry *        gconf_entry_copy                    (const GConfEntry *src);


gconf_entry_free ()

void                gconf_entry_free                    (GConfEntry *entry);

Warning

gconf_entry_free is deprecated and should not be used in newly-written code.


gconf_entry_ref ()

GConfEntry *        gconf_entry_ref                     (GConfEntry *entry);


gconf_entry_unref ()

void                gconf_entry_unref                   (GConfEntry *entry);


gconf_entry_steal_value ()

GConfValue *        gconf_entry_steal_value             (GConfEntry *entry);


gconf_entry_set_value ()

void                gconf_entry_set_value               (GConfEntry *entry,
                                                         const GConfValue *val);


gconf_entry_set_value_nocopy ()

void                gconf_entry_set_value_nocopy        (GConfEntry *entry,
                                                         GConfValue *val);


gconf_entry_set_schema_name ()

void                gconf_entry_set_schema_name         (GConfEntry *entry,
                                                         const gchar *name);


gconf_entry_set_is_default ()

void                gconf_entry_set_is_default          (GConfEntry *entry,
                                                         gboolean is_default);


gconf_entry_set_is_writable ()

void                gconf_entry_set_is_writable         (GConfEntry *entry,
                                                         gboolean is_writable);