Details
GDA_RECORDSET_INVALID_POSITION
#define GDA_RECORDSET_INVALID_POSITION 0xffffffff |
gda_recordset_new ()
Allocates space for a new recordset.
gda_recordset_free ()
This function frees all memory allocated by the recordset and
destroys all associations with commands and connections.
gda_recordset_set_name ()
void gda_recordset_set_name (GdaRecordset *rs,
gchar *name); |
gda_recordset_get_name ()
void gda_recordset_get_name (GdaRecordset *rs,
gchar *name); |
gda_recordset_close ()
This function closes the recordset and frees the memory occupied by
the actual data items. The recordset can be opened
again, doing the same query as before.
It is guaranteeed that the data cached by the recordset is
refetched from the server. Use this function is some
characteristics of the recordset must be changed
gda_recordset_field_name ()
Returns a pointer to the field with the name name of
the current row of the recordset.
gda_recordset_field_idx ()
Returns a pointer to the field at position idx of
the current row of the recordset.
gda_recordset_bof ()
This function is used to check if the recordset cursor is beyond
the first row.
If this function returns TRUE any of the functions which actually returns
the value of a field an error is returned because the cursor
doesn't point to a row.
gda_recordset_eof ()
This function is used to check if the recordset cursor is after
the last row.
If this function returns TRUE any of the functions which actually returns
the value of a field an error is returned because the cursor
doesn't point to a row.
gda_recordset_move ()
gulong gda_recordset_move (GdaRecordset *rs,
gint count,
gpointer bookmark); |
Moves the cursor of the recordset forward or backward. count is
the number of records to move. If count is negative the cursor is
moved towards the beginning. The function causes the recordset to
actually fetch records from the data source. Each fetch
from the data source fetches cachesize rows in one turn. A maximum
of maxrows rows can be fetched.
If the cursor is on the second row and the count parameter is -10,
then the cursor is position in front of the first record
available. gda_rcordset_bof() will return TRUE and
the return value of the function is two, because the cursor actually
moved two records.
gda_recordset_move_first ()
Moves the cursor of the recordset to the first record.
If the cursor is already on the the first record nothing happen.
gda_recordset_move_last ()
Moves the cursor of the recordset to the last record.
If the cursor is already on the the last record nothing happen.
gda_recordset_move_next ()
Moves the cursor of the recordset to the next record.
Has the same effect as calling gda_recordset_move() with count set to 1.
gda_recordset_move_prev ()
gda_recordset_affected_rows ()
Return the number of affected rows in the recordset
gda_recordset_open ()
gint gda_recordset_open (GdaRecordset *rs,
GdaCommand *cmd,
GDA_CursorType cursor_type,
GDA_LockType lock_type,
gulong options); |
This function opens a recordset. The recordset is filled with the
output of cmd. Before this function is called various parameters
of the recordst might be changed. This is the most featurefull
function for retrieving results from a database.
gda_recordset_open_txt ()
gint gda_recordset_open_txt (GdaRecordset *rs,
gchar *txt,
GDA_CursorType cursor_type,
GDA_LockType lock_type,
gulong options); |
This function opens a recordset. The recordset is filled with the
output of txt. Before this function is called various parameters
of the recordst might be changed. This is the most featurefull
function for retrieving results from a database.
gda_recordset_set_connection ()
Associates a recordset with a connection. This function must not be
called on a already opened recordst.
This function must be called before any of the the
gda_recordset_open_txt() or gda_recordset_open_cmd() functions is
called.
gda_recordset_get_connection ()
gda_recordset_add_field ()
gda_recordset_get_cursorloc ()
GDA_CursorLocation gda_recordset_get_cursorloc
(GdaRecordset *rs); |
gda_recordset_set_cursorloc ()
void gda_recordset_set_cursorloc (GdaRecordset *rs,
GDA_CursorLocation loc); |
Set the cursor location attribute to loc.
gda_recordset_get_cursortype ()
GDA_CursorType gda_recordset_get_cursortype (GdaRecordset *rs); |
gda_recordset_set_cursortype ()
void gda_recordset_set_cursortype (GdaRecordset *rs,
GDA_CursorType type); |
Set the cursor type attribute to type.