![]() |
![]() |
![]() |
GNOME Data Access 4 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
GdaBatch; enum GdaBatchError; 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 . [transfer full]
|
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. [element-type GdaStatement][transfer none GdaStatement] |
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
.
|
a GdaBatch object |
|
a place to store a new GdaSet object, or NULL . [out][transfer full][allow-none]
|
|
a place to store errors, or NULL
|
Returns : |
TRUE if no error occurred. |
"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. |