moveBy( )

Moves the position of the current record in an AGDBSet object by a specified number of rows.

Interface

AGDBSet

IDL definition
boolean moveBy(long numRecords);
ADO equivalent

Move method

JavaScript synopsis

dbset.moveBy(numRecords)

C synopsis
PODSBoolean AVmoveBy(
  AGDBSet* dbset,
  PODSInt32 numRecords
);
Parameters
  • dbset   The AGDBSet object.

  • numRecords   [in] The number of rows to move by.

Returns

TRUE on success; FALSE otherwise.

Remarks

If the numRecords argument is greater than zero, the current record position moves forward (toward the end of the AGDBSet object). If the numRecords is less than zero, the current record position moves backward (toward the beginning of the AGDBSet object).