GNOME Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#define gnome_config_get_string_with_default(path,def) |
Retrieves & returns the value of a configuration item as a string. The returned value should be g_free()'d when no longer needed.
#define gnome_config_get_translated_string_with_default(path,def) |
Retrieves & returns the value of a configuration item as a string appropriate for the current language. The returned value should be g_free()'d when no longer needed.
#define gnome_config_get_int_with_default(path,def) |
Retrieves & returns the value of a configuration item as an integer.
#define gnome_config_get_float_with_default(path,def) |
Retrieves & returns the value of a configuration item as a floating-point number.
#define gnome_config_get_bool_with_default(path,def) |
Retrieves & returns the value of a configuration item as a boolean.
#define gnome_config_get_vector_with_default(path, argcp, argvp, def) |
Retrieves & returns the value of a configuration item as a string array. The returned value should be g_free()'d when no longer needed.
#define gnome_config_private_get_string_with_default(path,def) |
Retrieves & returns the value of a configuration item as a string. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_translated_string_with_default(path,def) |
Retrieves & returns the value of a configuration item as a string appropriate for the current language. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_int_with_default(path,def) |
Retrieves & returns the value of a configuration item as an integer. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_float_with_default(path,def) |
Retrieves & returns the value of a configuration item as a floating-point number. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_bool_with_default(path,def) |
Retrieves & returns the value of a configuration item as a boolean. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_vector_with_default(path, argcp, argvp, def) |
Retrieves & returns the value of a configuration item as a string array. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_get_string(path) |
Retrieves & returns the value of a configuration item as a string. The returned value should be g_free()'d when no longer needed.
#define gnome_config_get_translated_string(path) |
Retrieves & returns the value of a configuration item as a string appropriate for the current language. The returned value should be g_free()'d when no longer needed.
#define gnome_config_get_int(path) |
Retrieves & returns the value of a configuration item as an integer.
#define gnome_config_get_float(path) |
Retrieves & returns the value of a configuration item as a floating-point number.
#define gnome_config_get_bool(path) |
Retrieves & returns the value of a configuration item as a boolean.
#define gnome_config_get_vector(path, argcp, argvp) |
Retrieves & returns the value of a configuration item as a string array. The returned value should be g_free()'d when no longer needed.
#define gnome_config_private_get_string(path) |
Retrieves & returns the value of a configuration item as a string. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_translated_string(path) |
Retrieves & returns the value of a configuration item as a string appropriate for the current language. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_int(path) |
Retrieves & returns the value of a configuration item as an integer. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_float(path) |
Retrieves & returns the value of a configuration item as a floating-point number. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_bool(path) |
Retrieves & returns the value of a configuration item as a boolean. The item is retrieved from the user's private configuration storage area.
#define gnome_config_private_get_vector(path, argcp, argvp) |
Retrieves & returns the value of a configuration item as a string. The returned value should be g_free()'d when no longer needed. The item is retrieved from the user's private configuration storage area.
#define gnome_config_set_string(path,new_value) |
Stores the string value new_value in the file/section/key defined by the path
#define gnome_config_set_translated_string(path,value) |
Stores the string value new_value in the file/section/key defined by the path on the proper section for the current language set by by the user.
#define gnome_config_set_int(path,new_value) |
Stores the integer value new_value in the file/section/key defined by the path
#define gnome_config_set_float(path,new_value) |
Stores the double value new_value in the file/section/key defined by the path
#define gnome_config_set_bool(path,new_value) |
Stores boolean value new_value in the file/section/key defined by path.
#define gnome_config_set_vector(path,argc,argv) |
Stores vector argv in the file/section/key defined by path.
#define gnome_config_private_set_translated_string(path,new_value) |
#define gnome_config_has_section(path) |
Queries the gnome configuration file for the presence of the section specified in path.
#define gnome_config_private_has_section(path) |
Queries the private gnome configuration file for the presence of the section specified in path.
#define gnome_config_init_iterator(path) |
Creates an iterator handle that can be used to iterate over the keys in a section in a gnome configuration file. path must refer to a section. The returned value can be used as an iterator for #gnome_config_iterator_next().
#define gnome_config_private_init_iterator(path) |
Creates an iterator handle that can be used to iterate over the keys in a section in a private gnome configuration file. path must refer to a section. The returned value can be used as an iterator for #gnome_config_iterator_next().
#define gnome_config_init_iterator_sections(path) |
Creates an iterator handle that can be used to iterate over the sections in a gnome configuration file. path must refer to a gnome configuration file. The returned value can be used as an iterator for #gnome_config_iterator_next().
#define gnome_config_private_init_iterator_sections(path) |
Creates an iterator handle that can be used to iterate over the sections in a private gnome configuration file. path must refer to a gnome configuration file. The returned value can be used as an iterator for #gnome_config_iterator_next().
void* gnome_config_iterator_next (void *iterator_handle, char **key, char **value); |
void gnome_config_drop_all (void); |
Drops any information cached in memory that was fetched with gnome config. Any pending information that has not been written to disk is discarded.
gboolean gnome_config_sync (void); |
Writes all of the information modified by gnome-config to the disk.
Note: the gnome_config code does not write anything to the configuration files until this routine is actually invoked.
#define gnome_config_sync_file(path) |
Writes all of the information modified by gnome-config to the disk for the given file.
Note: the gnome_config code does not write anything to the configuration files until this routine or gnome_config_sync is actually invoked.
#define gnome_config_private_sync_file(path) |
Writes all of the information modified by gnome-config to the disk for the given private file.
Note: the gnome_config code does not write anything to the configuration files until this routine or gnome_config_sync is actually invoked.
#define gnome_config_drop_file(path) |
Releases any memory resources that were allocated from accessing the configuration file in path. Changes will take place after gnome_config_sync has been invoked
#define gnome_config_private_drop_file(path) |
Releases any memory resources that were allocated from accessing the private configuration file in path.
#define gnome_config_clean_file(path) |
Cleans up the configuration file specified by path from any configuration information.
Changes will take place after gnome_config_sync has been invoked.
#define gnome_config_private_clean_file(path) |
Cleans up the private configuration file specified by path from any configuration information.
Changes will take place after gnome_config_sync has been invoked.
#define gnome_config_clean_section(path) |
Cleans up the section specified by path from any configuration information. Changes will only take place after gnome_config_sync has been invoked.
#define gnome_config_private_clean_section(path) |
Cleans up the section specified by path in a private file from any configuration information. Changes will only take place after gnome_config_sync has been invoked.
#define gnome_config_clean_key(path) |
Removes the definition for the key on a gnome configuration file.
Changes will take place after gnome_config_sync has been invoked.
#define gnome_config_private_clean_key(path) |
Removes the definition for the key on a private gnome configuration file.
Changes will take place after gnome_config_sync has been invoked.
void gnome_config_push_prefix (const char *path); |
path is a prefix that will be prepended automatically to any non-absolute configuration path in gnome config.
This is used to simplify application loading code.
Library code will usually have to set the prefix before doing any gnome-configuration access, since the application might be using their own prefix.
void gnome_config_pop_prefix (void); |
Call this routine to remove the current configuration prefix from the stack.
void gnome_config_make_vector (const char *string, int *argcp, char ***argvp); |
Creates a new vector from a string as it stored in the config file, breaks the string on spaces except if the space is escaped with a backslash.
char* gnome_config_assemble_vector (int argc, const char *const argv[]); |
This routine returns the the strings in the array contactenated by spaces.
argc : | Number of elements in the argv string array. |
argv : | An array of strings. |
Returns : | a g_malloc()ed string with the concatenation results. |
void gnome_config_set_set_handler (void (*func) (void *), void *data); |
Internal Obsolete.