GETNEXTMODIFIED( ) Function

Returns the record number for the next modified record in a buffered table or cursor.

Syntax

GETNEXTMODIFIED(nRecordNumber [, cTableAlias | nWorkArea])

Returns

Numeric

Arguments

nRecordNumber

Specifies the record number after which GETNEXTMODIFIED( ) searches for the next modified record. Specify 0 for nRecordNumber to determine the first record in the table or cursor that has been modified.

cTableAlias

Specifies the alias of the table or cursor for which GETNEXTMODIFIED( ) returns the number of the next modified record.

nWorkArea

Specifies the work area of the table or cursor for which GETNEXTMODIFIED( ) returns the number of the next modified record.

If you do not specify an alias or work area, GETNEXTMODIFIED( ) returns the record number for the next modified record in the currently selected table or cursor.

Remarks

GETNEXTMODIFIED( ) returns 0 if there are no modified records after the record you specify. A record is considered modified if the contents of any of its fields are changed in any way (even if the original field contents are restored) or the record's deletion status is changed.

GETNEXTMODIFIED( ) can operate only on tables and cursors for which table buffering is enabled. Table buffering is enabled with CURSORSETPROP( ).