
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Advantage CA-Clipper Guide v5.5 - ax_chooseordbagext()
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
AX_ChooseOrdBagExt()
Allows the programmer to choose which extension ordBagExt() will return for
the DBFCDXAX RDD
------------------------------------------------------------------------------
Syntax
AX_ChooseOrdBagExt( [<cBagExt>] ) -> charstring
<cBagExt> An optional character string specifying the index
extension to be returned by the ordBagExt() function for the
DBFCDXAX RDD. Valid values are ".IDX" and ".CDX". The default
value is ".IDX".
Returns
If no parameter is passed, then it returns the current index
extension that will be returned by ordBagExt() for the DBFCDXAX
RDD. If a parameter is passed, then it returns the previous index
extension that was returned by ordBagExt() for the DBFCDXAX RDD.
Description
CA-Clipper's ordBagExt() returns the default index extension for
the current RDD. CA-Clipper's DBFCDX RDD and Loadstone's COMIX RDD
return ".CDX" from the ordBagExt() function. By default, Advantage's
DBFCDXAX RDD returns ".IDX" from the ordBagExt() function.
AX_ChooseOrdBagExt() allows the programmer to choose which extension
ordBagExt() should return for the DBFCDXAX RDD. Therefore, the
Advantage "default" index extension for its CDX RDD can be changed
to ".CDX" so that ordBagExt() will return the same value as
CA-Clipper's DBFCDX RDD and Loadstone's COMIX RDD.
Note: The Advantage DBFCDXAX RDD existed before the CA-Clipper
DBFCDX RDD and the Loadstone COMIX RDD. Thus, by existing first,
Advantage "defined" the standard return value for the "index
extension" functions to be ".IDX" for CDX/IDX RDDs. DBFCDX and COMIX
chose to not follow this standard and returned ".CDX" instead.
Advantage cannot change it's default of ".IDX" as that would likely
break existing Advantage applications who rely on the returned value
to be ".IDX". Thus, we provided this AX_ChooseOrdBagExt() function
for those who want the returned value to be ".CDX".
Note: AX_ChooseOrdBagExt() has no effect on the Advantage NTX RDD,
DBFNTXAX. OrdBagExt() will always return ".NTX" for the DBFNTXAX
RDD.
Example
USE test VIA "DBFCDXAX"
? AX_ChooseOrdBagExt() // Will return ".IDX"
? ordBagExt() // Will return ".IDX"
// Change Advantage's "default" index extension to .CDX
AX_ChooseOrdBagExt( ".CDX" )
? ordBagExt() // Will return ".CDX"
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson