gok-gconf

gok-gconf

Synopsis

gboolean            gok_gconf_get_int                   (GConfClient *client,
                                                         const gchar *key,
                                                         gint *dest);
gboolean            gok_gconf_set_int                   (GConfClient *client,
                                                         const gchar *key,
                                                         gint value);
gboolean            gok_gconf_get_bool                  (GConfClient *client,
                                                         const gchar *key,
                                                         gboolean *dest);
gboolean            gok_gconf_set_bool                  (GConfClient *client,
                                                         const gchar *key,
                                                         gboolean value);
gboolean            gok_gconf_get_string                (GConfClient *client,
                                                         const gchar *key,
                                                         gchar **dest);
gboolean            gok_gconf_set_string                (GConfClient *client,
                                                         const gchar *key,
                                                         const gchar *value);

Description

Details

gok_gconf_get_int ()

gboolean            gok_gconf_get_int                   (GConfClient *client,
                                                         const gchar *key,
                                                         gint *dest);

Retrieves the requested key and stores it in the given dest. If an error occurs during retreiving the key a message is logged using gok_log_x and dest is left unchanged.

client :

GConfClient to use to retreive the key.

key :

GConf key to retrieve.

dest :

Pointer to a gint to store the retrieved key, if successful.

Returns :

TRUE if key retrieved successfully, FALSE if an error occured.

gok_gconf_set_int ()

gboolean            gok_gconf_set_int                   (GConfClient *client,
                                                         const gchar *key,
                                                         gint value);

Stores the given (key, value) pair if it is different from what is in GConf already. If an error occurs during storing the key a message is logged using gok_log_x.

client :

GConfClient to use to set the value.

key :

GConf key to set.

value :

gint to store.

Returns :

TRUE if key stored successfully, FALSE if an error occured.

gok_gconf_get_bool ()

gboolean            gok_gconf_get_bool                  (GConfClient *client,
                                                         const gchar *key,
                                                         gboolean *dest);

Retrieves the requested key and stores it in the given dest. If an error occurs during retreiving the key a message is logged using gok_log_x and dest is left unchanged.

client :

GConfClient to use to retreive the key.

key :

GConf key to retrieve.

dest :

Pointer to a gboolean to store the retrieved key, if successful.

Returns :

TRUE if key retrieved successfully, FALSE if an error occured.

gok_gconf_set_bool ()

gboolean            gok_gconf_set_bool                  (GConfClient *client,
                                                         const gchar *key,
                                                         gboolean value);

Stores the given (key, value) pair if it is different from what is in GConf already. If an error occurs during storing the key a message is logged using gok_log_x.

client :

GConfClient to use to set the value.

key :

GConf key to set.

value :

gboolean to store.

Returns :

TRUE if key stored successfully, FALSE if an error occured.

gok_gconf_get_string ()

gboolean            gok_gconf_get_string                (GConfClient *client,
                                                         const gchar *key,
                                                         gchar **dest);

Retrieves the requested key and stores it in the given dest. If an error occurs during retreiving the key a message is logged using gok_log_x and dest is left unchanged.

NOTE: *dest needs to be freed when finished with.

client :

GConfClient to use to retreive the key.

key :

GConf key to retrieve.

dest :

Pointer to a pointer to a gchar to store the retrieved key, if successful.

Returns :

TRUE if key retrieved successfully, FALSE if an error occured.

gok_gconf_set_string ()

gboolean            gok_gconf_set_string                (GConfClient *client,
                                                         const gchar *key,
                                                         const gchar *value);

Stores the given (key, value) pair if it is different from what is in GConf already. If an error occurs during storing the key a message is logged using gok_log_x.

client :

GConfClient to use to set the value.

key :

GConf key to set.

value :

gchar to store.

Returns :

TRUE if key stored successfully, FALSE if an error occured.