|  |  |  | GNOME Data Access manual |  | 
|---|---|---|---|---|
            GdaQuarkList;
GdaQuarkList* gda_quark_list_new            (void);
GdaQuarkList* gda_quark_list_new_from_string
                                            (const gchar *string);
void        gda_quark_list_clear            (GdaQuarkList *qlist);
void        gda_quark_list_free             (GdaQuarkList *qlist);
GdaQuarkList* gda_quark_list_copy           (GdaQuarkList *qlist);
void        gda_quark_list_add_from_string  (GdaQuarkList *qlist,
                                             const gchar *string,
                                             gboolean cleanup);
const gchar* gda_quark_list_find            (GdaQuarkList *qlist,
                                             const gchar *name);
void        gda_quark_list_remove           (GdaQuarkList *qlist,
                                             const gchar *name);
void        gda_quark_list_foreach          (GdaQuarkList *qlist,
                                             GHFunc func,
                                             gpointer user_data);
GdaQuarkList* gda_quark_list_new (void);
Creates a new GdaQuarkList, which is a set of key->value pairs, very similar to GLib's GHashTable, but with the only purpose to make easier the parsing and creation of data source connection strings.
| Returns : | the newly created GdaQuarkList. | 
GdaQuarkList* gda_quark_list_new_from_string (const gchar *string);
Creates a new GdaQuarkList given a connection string.
| string: | a connection string. | 
| Returns : | the newly created GdaQuarkList. | 
void gda_quark_list_clear (GdaQuarkList *qlist);
Removes all strings in the given GdaQuarkList.
| qlist: | a GdaQuarkList. | 
void gda_quark_list_free (GdaQuarkList *qlist);
Releases all memory occupied by the given GdaQuarkList.
| qlist: | a GdaQuarkList. | 
GdaQuarkList* gda_quark_list_copy (GdaQuarkList *qlist);
Creates a new GdaQuarkList from an existing one.
| qlist: | quark_list to get a copy from. | 
| Returns : | a newly allocated GdaQuarkList with a copy of the data in qlist. | 
void gda_quark_list_add_from_string (GdaQuarkList *qlist, const gchar *string, gboolean cleanup);
Adds new key->value pairs from the given string. If cleanup is
set to TRUE, the previous contents will be discarded before adding
the new pairs.
| qlist: | a GdaQuarkList. | 
| string: | a connection string. | 
| cleanup: | whether to cleanup the previous content or not. | 
const gchar* gda_quark_list_find (GdaQuarkList *qlist, const gchar *name);
Searches for the value identified by name in the given GdaQuarkList.
| qlist: | a GdaQuarkList. | 
| name: | the name of the value to search for. | 
| Returns : | the value associated with the given key if found, or NULLif not found. | 
void gda_quark_list_remove (GdaQuarkList *qlist, const gchar *name);
Removes an entry from the GdaQuarkList, given its name.
| qlist: | a GdaQuarkList structure. | 
| name: | an entry name. | 
void gda_quark_list_foreach (GdaQuarkList *qlist, GHFunc func, gpointer user_data);
Calls the given function for each of the key/value pairs in qlist. The function is passed the key and value 
of each pair, and the given user_data parameter. qlist may not be modified while iterating over it.
| qlist: | a GdaQuarkList structure. | 
| func: | the function to call for each key/value pair | 
| user_data: | user data to pass to the function |