![]() | ![]() | ![]() | GNOME Data Access manual | ![]() |
---|
gda-quark-list — Quark lists (lists of KEY=VALUE's)
struct GdaQuarkList; #define GDA_TYPE_QUARK_LIST GType gda_quark_list_get_type (void); GdaQuarkList* gda_quark_list_new (void); GdaQuarkList* gda_quark_list_new_from_string (const gchar *string); GdaQuarkList* gda_quark_list_copy (GdaQuarkList *qlist); void gda_quark_list_free (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_clear (GdaQuarkList *qlist);
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. |
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_free (GdaQuarkList *qlist);
Releases all memory occupied by the given GdaQuarkList.
qlist : | a GdaQuarkList. |
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 NULL
if 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_clear (GdaQuarkList *qlist);
Removes all strings in the given GdaQuarkList.
qlist : | a GdaQuarkList. |
<< gda-parameter | gda-row >> |