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 v5.5 - aofgetmaxrecords() http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 aofGetMaxRecords()
 Get the maximum record number that can be in a Client Advantage Optimized
 Filter
------------------------------------------------------------------------------

Syntax

     aofGetMaxRecords( <nHandle> ) -> numeric

     <nHandle>  Handle to an existing filter.

Returns

     aofGetMaxRecords() returns the maximum record number that can be in
     the filter.

Description

     aofGetMaxRecords() returns the maximum record number that can be in
     the filter. This is effectively the length of the filter. If a filter
     is created with aofSetFilter() or with aofCreateFilter( <cExpr> ),
     then the maximum record number will be equal to the number of records
     in the table. If a filter is created with
     aofCreateFilter( <nLength> ), then the maximum record number will
     be equal to <nLength>.

Example

     // Open a table and index with 1000 records in it.
     USE customer VIA "DBFCDXAX" INDEX state

     nHandle1 := aofCreateFilter( 50 )
     nHandle2 := aofCreateFilter()
     nHandle3 := aofCreateFilter( "state = 'CA'" )

     aofGetMaxRecords( nHandle1 )     // Returns 50
     aofGetMaxRecords( nHandle2 )     // Returns 1000
     aofGetMaxRecords( nHandle3 )     // Returns 1000

     aofFreeFilter( nHandle1 )
     aofFreeFilter( nHandle2 )
     aofFreeFilter( nHandle3 )


See Also: aofCreateFilter() aofSetFilter() aofFilterInfo()

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