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

 aofSaveFilter()
 Saves a system-owned Client Advantage Optimized Filter to memory
------------------------------------------------------------------------------

Syntax

     aofSaveFilter() -> character string

Returns

     Returns a string with the current system-owned filter state.

Description

     aofSaveFilter() will save the current state of the system-owned
     filter in the form of a character string.  This allows you to stack
     filters, or swap filters without repeating the work performed in
     executing the original aofSetFilter().

     This function will actually make a copy of the system-owned filter
     to save it. So, you must either restore the filter (using
     aofRestoreFilter()), or destroy the filter (using
     aofDestroyFilter()) when you are done using it.

Example

     USE customer INDEX last, age

     // Create a system-owned filter
     aofSetFilter( "age = 30" )

     // Save the filter
     cSaveFilt := aofSaveFilter()

     // Create a new system-owned filter
     aofSetFilter( "age = 31" )

     LIST last, age              // Will list all the 31's in last order

     // Restore the saved filter
     aofRestoreFilter( cSaveFilt )

     LIST last, age              // Will list all the 30's in last order