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

 aofRemoveRecord()
 Removes a record from a Client Advantage Optimized Filter
------------------------------------------------------------------------------

Syntax

     aofRemoveRecord( <nHandle>, <nRecord> ) -> logical

     <nHandle>  Handle to an existing filter.

     <nRecord>  Record number of record to add to the filter.

Returns

     Returns .T. if the operation was successful; .F. indicates it failed.
     If aofRemoveRecord() failed, aofErrorCode() will return information
     on why the function failed.

Description

     Removes the specified record from a user-owned or a system-owned
     filter. To remove a record from a system-owned filter using
     aofRemoveRecord(), you must first get a handle to that system-owned
     filter via the aofGetFilterHandle() function.

Example

     USE Customer VIA "DBFCDXAX"

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

     // Add records to the filter
     aofAddRecord( nHandle,  5 )
     aofAddRecord( nHandle, 10 )
     aofAddRecord( nHandle, 15 )
     aofAddRecord( nHandle, 20 )

     ? aofCountRecords()           // 4

     // Remove record 15 from the filter
     aofRemoveRecord( nHandle, 15 )

     ? aofCountRecords()           // 3

     // Free the user-owned filter
     aofFreeFilter( nHandle )