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.