
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Advantage CA-Clipper Guide v6.11 - aofgobottom()
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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 )
See Also: aofGoTop() aofGoRecord() aofSkip() aofGetRecord()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson