![]() |
![]() |
![]() |
GNOME Data Access 3.0 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
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.
|
a connection string. |
Returns : |
the newly created GdaQuarkList. |
void gda_quark_list_clear (GdaQuarkList *qlist
);
Removes all strings in the given GdaQuarkList.
|
a GdaQuarkList. |
void gda_quark_list_free (GdaQuarkList *qlist
);
Releases all memory occupied by the given GdaQuarkList.
|
a GdaQuarkList. |
GdaQuarkList * gda_quark_list_copy (GdaQuarkList *qlist
);
Creates a new GdaQuarkList from an existing one.
|
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.
|
a GdaQuarkList. |
|
a connection string. |
|
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.
|
a GdaQuarkList. |
|
the name of the value to search for. |
Returns : |
the value associated with the given key if found, or NULL
if not found. |
void gda_quark_list_remove (GdaQuarkList *qlist
,const gchar *name
);
Removes an entry from the GdaQuarkList, given its name.
|
a GdaQuarkList structure. |
|
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.
|
a GdaQuarkList structure. |
|
the function to call for each key/value pair |
|
user data to pass to the function |