| GNOME Data Access manual |
|---|
gchar* gda_config_get_string (const gchar *path); gint gda_config_get_int (const gchar *path); gdouble gda_config_get_float (const gchar *path); gboolean gda_config_get_boolean (const gchar *path); void gda_config_set_string (const gchar *path, const gchar *new_value); void gda_config_set_int (const gchar *path, gint new_value); void gda_config_set_float (const gchar *path, gdouble new_value); void gda_config_set_boolean (const gchar *path, gboolean new_value); void gda_config_remove_section (const gchar *path); void gda_config_remove_key (const gchar *path); gboolean gda_config_has_section (const gchar *path); gboolean gda_config_has_key (const gchar *path); GList* gda_config_list_sections (const gchar *path); GList* gda_config_list_keys (const gchar *path); gchar* gda_config_get_type (const gchar *path); void gda_config_free_list (GList *list); void (*GdaConfigListenerFunc) (const gchar *path, gpointer user_data); guint gda_config_add_listener (const gchar *path, GdaConfigListenerFunc func, gpointer user_data); void gda_config_remove_listener (guint id); typedef GdaProviderInfo; GList* gda_config_get_provider_list (void); void gda_config_free_provider_list (GList *list); GdaProviderInfo* gda_config_get_provider_by_name (const gchar *name); void gda_config_free_provider_info (GdaProviderInfo *provider_info); typedef GdaDataSourceInfo; GList* gda_config_get_data_source_list (void); GdaDataSourceInfo* gda_config_find_data_source (const gchar *name); GdaDataSourceInfo* gda_config_copy_data_source_info (GdaDataSourceInfo *info); void gda_config_free_data_source_info (GdaDataSourceInfo *info); void gda_config_free_data_source_list (GList *list); GdaDataModel* gda_config_get_data_source_model (void); void gda_config_save_data_source (const gchar *name, const gchar *provider, const gchar *cnc_string, const gchar *description, const gchar *username, const gchar *password); void gda_config_remove_data_source (const gchar *name); #define GDA_CONFIG_BASE #define GDA_CONFIG_SECTION_DATASOURCES #define GDA_CONFIG_SECTION_LAST_CONNECTIONS #define GDA_CONFIG_KEY_MAX_LAST_CONNECTIONS
gchar* gda_config_get_string (const gchar *path);
Gets the value of the specified configuration entry as a string. You are then responsible to free the returned string
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gint gda_config_get_int (const gchar *path);
Gets the value of the specified configuration entry as an integer
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gdouble gda_config_get_float (const gchar *path);
Gets the value of the specified configuration entry as a float
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
gboolean gda_config_get_boolean (const gchar *path);
Gets the value of the specified configuration entry as a boolean
| path : | path to the configuration entry |
| Returns : | the value stored at the given entry |
void gda_config_set_string (const gchar *path,
const gchar *new_value);Sets the given configuration entry to contain a string
| path : | path to the configuration entry |
| new_value : | new value |
void gda_config_set_int (const gchar *path,
gint new_value);Sets the given configuration entry to contain an integer
| path : | path to the configuration entry |
| new_value : | new value |
void gda_config_set_float (const gchar *path,
gdouble new_value);Sets the given configuration entry to contain a float
| path : | path to the configuration entry |
| new_value : | new value |
void gda_config_set_boolean (const gchar *path,
gboolean new_value);Sets the given configuration entry to contain a boolean
| path : | path to the configuration entry |
| new_value : | new value |
void gda_config_remove_section (const gchar *path);
Remove the given section from the configuration database
| path : | path to the configuration section |
void gda_config_remove_key (const gchar *path);
Remove the given entry from the configuration database If the section is empty, also remove the section.
| path : | path to the configuration entry |
gboolean gda_config_has_section (const gchar *path);
Checks whether the given section exists in the configuration system
| path : | path to the configuration section |
| Returns : | TRUE if the section exists, FALSE otherwise |
gboolean gda_config_has_key (const gchar *path);
Check whether the given key exists in the configuration system
| path : | path to the configuration key |
| Returns : | TRUE if the entry exists, FALSE otherwise |
GList* gda_config_list_sections (const gchar *path);
Return a GList containing the names of all the sections available under the given root directory.
To free the returned value, you can use gda_config_free_list
| path : | path for root dir |
| Returns : | a list containing all the section names |
GList* gda_config_list_keys (const gchar *path);
Returns a list of all keys that exist under the given path.
To free the returned value, you can use gda_config_free_list
| path : | path for root dir |
| Returns : | a list containing all the key names |
gchar* gda_config_get_type (const gchar *path);
Gets a string representing the type of the value of the given key. The caller is responsible of freeing the returned value.
| path : | path to the configuration key |
| Returns : | NULL if not found. Otherwise: "string", "float", "long", "bool". |
void gda_config_free_list (GList *list);
Free all memory used by the given GList, which must be the return value from either gda_config_list_sections and gda_config_list_keys
| list : | list to be freed |
void (*GdaConfigListenerFunc) (const gchar *path,
gpointer user_data);| path : | |
| user_data : |
|
guint gda_config_add_listener (const gchar *path,
GdaConfigListenerFunc func,
gpointer user_data);Installs a configuration listener, which is a callback function which will be called every time a change occurs on a given configuration entry.
| path : | configuration path to listen to. |
| func : | callback function. |
| user_data : | data to be passed to the callback function. |
| Returns : | the ID of the listener, which you will need for calling gda_config_remove_listener. If an error occurs, 0 is returned. |
typedef struct {
gchar *id;
gchar *location;
gchar *description;
GList *gda_params;
} GdaProviderInfo;GList* gda_config_get_provider_list (void);
Return a list of all providers currently installed in the system. Each of the nodes in the returned GList is a GdaProviderInfo. To free the returned list, call the gda_config_free_provider_list function.
| Returns : | a GList of GdaProviderInfo structures. |
void gda_config_free_provider_list (GList *list);
Free a list of GdaProviderInfo structures.
| list : | the list to be freed. |
GdaProviderInfo* gda_config_get_provider_by_name (const gchar *name);
| name : | |
| Returns : |
|
void gda_config_free_provider_info (GdaProviderInfo *provider_info);
| provider_info : |
|
typedef struct {
gchar *name;
gchar *provider;
gchar *cnc_string;
gchar *description;
gchar *username;
gchar *password;
} GdaDataSourceInfo;GdaDataSourceInfo* gda_config_find_data_source (const gchar *name);
| name : | |
| Returns : |
|
GdaDataSourceInfo* gda_config_copy_data_source_info (GdaDataSourceInfo *info);
| info : | |
| Returns : |
|
void gda_config_free_data_source_info
(GdaDataSourceInfo *info);| info : |
|
void gda_config_save_data_source (const gchar *name,
const gchar *provider,
const gchar *cnc_string,
const gchar *description,
const gchar *username,
const gchar *password);Adds a new data source (or update an existing one) to the GDA configuration, based on the parameters given.
| name : | Name for the data source to be saved. |
| provider : | Provider ID for the new data source. |
| cnc_string : | Connection string for the new data source. |
| description : | Description for the new data source. |
| username : | User name for the new data source. |
| password : | Password to use when authenticating username. |
void gda_config_remove_data_source (const gchar *name);
Removes the given data source from the GDA configuration.
| name : | Name for the data source to be removed. |
#define GDA_CONFIG_SECTION_LAST_CONNECTIONS "/apps/libgda/LastConnections"
| <<< gda-command | GdaConnection >>> |