Click above to get retro games delivered to your door ever month!

 aofGoRecord()
 Position to the specified record in the user-owned Client Advantage
 Optimized Filter
------------------------------------------------------------------------------

Syntax

     aofGoRecord( <nHandle>, <nRecord> ) -> numeric

     <nHandle>  Handle to an existing user-owned filter.

     <nRecord>  Record number to position to within the filter.

Returns

     Returns the numeric record number positioned to in the filter. A
     return value of  0 (zero) indicates either an error occurred or that
     there were no records in the filter. If aofGoRecord() returned zero,
     aofErrorCode() will return information on why the function returned
     zero.

Description

     aofGoRecord() positions a user-owned filter to the specified record
     in the filter. If this function is passed a handle for a user-owned
     filter, then the system's record number (returned by the recno()
     function) will not change. The record number returned by
     aofGetRecord() will be affected, however.

Example

     // Create an empty, user-owned filter
     nHandle := aofCreateFilter()

     // Add records 5, 10, 15, and 20 to the filter
     ? aofAddRecord( nHandle,  5 )  // .T.
     ? aofAddRecord( nHandle, 10 )  // .T.
     ? aofAddRecord( nHandle, 15 )  // .T.
     ? aofAddRecord( nHandle, 20 )  // .T.

     // Go to record 15 in the filter
     ? aofGoRecord( nHandle, 15 )       // 15

     // Free the memory for this user-owned filter
     aofFreeFilter( nHandle )