Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Advantage CA-Clipper Guide v6.11 - aofrestorefilter() http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 aofRestoreFilter()
 Restores a system-owned Client Advantage Optimized Filter that was stored in
 memory
------------------------------------------------------------------------------

Syntax

     aofRestoreFilter( <cFiltString> ) -> logical

     <cFiltString>  Character string with previously saved filter
     information.

Returns

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

Description

     Restores the filter state using a saved version (previously set up
     by aofSaveFilter()). The filter will be restored as the currently
     active system-owned filter.

     This allows you to stack filters, or swap filters without repeating
     the work performed in executing the original aofSetFilter().

     aofRestoreFilter() will restore saved versions of the filter
     condition and the records in the filter.

     Note:  aofRestoreFilter() destroys the saved filter. You can only
     restore a saved filter once.

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


See Also: aofDestroyFilter() aofSaveFilter()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson