## 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.