gda_recordset_move

Name

gda_recordset_move -- 

Synopsis

gulong gda_recordset_move (Gda_Recordset* rs, gint count, gpointer bookmark);

Arguments

rs

the recordset

count

The number of records to skip

bookmark

if not NULL, the cursor is positioned relative to the record described by this paramter. seee gda_recordset_get_bookmark() how to get bookmark values for records.

Description

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.

Returns

the number of the record the cursor is addressing after the move or GDA_RECORDSET_INVALID_POSITION if there was an error fetching the rows.