dbMoveNext()

Database function which moves the data record pointer to the next record in the record set.

Synopsis

int dbMoveNext(dbRecordset recordset);

Parameters

Parameter Meaning
recordset Record set reference

Return Value

The return value is an error code; 0 indicates the operation has been performed successfully. For other values dbGetError() can be used to obtain detailed error information.

Errors

An error is returned if an invalid record set reference variable is passed, or if positioning after the last data record in the record set.

Description

dbMoveNext() is called in order to make the record located after the current record in a record set the current record. This method is permitted for all cursor types.

One should note that unconfirmed changes (i.e. data fields changed by dbPutField() without dbUpate()) are automatically saved in the data source by an (internal) dbUpdate() call when the data record pointer is changed.

Example

see dbOpenRecordset()

Assignment

ADO and Qt, Database functions

Availability

CTRL