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

 aofGoBottom()
 Position to the last record in a user-owned Client Advantage Optimized Filter
------------------------------------------------------------------------------

Syntax

     aofGoBottom( <nHandle> ) -> numeric

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

Returns

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

Description

     aofGoBottom() positions a user-owned filter to the last 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 the last record in the filter
     ? aofGoBottom( nHandle )       // 20

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