![]() |
![]() |
![]() |
GNOME Data Access 4 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
GdaBatch; GdaBatch * gda_batch_new (void); GdaBatch * gda_batch_copy (GdaBatch *orig); void gda_batch_add_statement (GdaBatch *batch, GdaStatement *stmt); void gda_batch_remove_statement (GdaBatch *batch, GdaStatement *stmt); gchar * gda_batch_serialize (GdaBatch *batch); const GSList * gda_batch_get_statements (GdaBatch *batch); gboolean gda_batch_get_parameters (GdaBatch *batch, GdaSet **out_params, GError **error);
The GdaBatch object represents one or more SQL statements (as GdaStatement objects) in a single object.
A GdaBatch can either be built "manually" by assembling together several GdaStatement objects, or from an SQL string using a GdaSqlParser object.
GdaBatch * gda_batch_new (void);
Creates a new GdaBatch object
Returns : |
the new object |
GdaBatch * gda_batch_copy (GdaBatch *orig);
Copy constructor
|
a GdaBatch to make a copy of |
Returns : |
a the new copy of orig
|
void gda_batch_add_statement (GdaBatch *batch, GdaStatement *stmt);
Add stmt
to the list of statements managed by batch
. A GdaStatement object can be
added multiple times to a GdaBatch object.
|
a GdaBatch object |
|
a statement to add to batch 's statements list
|
void gda_batch_remove_statement (GdaBatch *batch, GdaStatement *stmt);
Removes stmt
from the list of statements managed by batch
. If stmt
is present several
times in batch
's statements' list, then only the first one is removed.
|
a GdaBatch object |
|
a statement to remove from batch 's statements list
|
gchar * gda_batch_serialize (GdaBatch *batch);
Creates a string representing the contents of batch
.
|
a GdaBatch object |
Returns : |
a string containing the serialized version of batch
|
const GSList * gda_batch_get_statements (GdaBatch *batch);
Get a list of the GdaStatement objects contained in batch
|
a GdaBatch object |
Returns : |
a list of GdaStatement which should not be modified. |
gboolean gda_batch_get_parameters (GdaBatch *batch, GdaSet **out_params, GError **error);
Get a new GdaSet object which groups all the execution parameters
which batch
needs for all the statements it includes.
This new object is returned though out_params
.
Note that if batch
does not need any parameter, then out_params
is set to NULL
.
"changed"
signalvoid user_function (GdaBatch *batch, GObject *changed_stmt, gpointer user_data) : Run First
Gets emitted whenever a GdaStatement in the batch
object changes
|
the GdaBatch object |
|
the statement which has been changed |
|
user data set when the signal handler was connected. |