ORDDESTROY()
Remove a specified Order from an Order Bag
- Syntax
- ORDDESTROY(<cOrderName> [, <cOrderBagName> ]) --> NIL
- Arguments
- <cOrderName> is the name of the Order to be removed from the current or specified work area.
- <cOrderBagName> is the name of a disk file containing one or more Orders. You may specify <cOrderBagName> as the filename with or without the pathname or appropriate extension. If you do not include the extension as part of <cOrderBagName> HARBOUR uses the default extension of the current RDD.
- Returns
- ORDDESTROY() always returns NIL.
- Description
- ORDDESTROY() is an Order management function that removes a specified Order from multiple-Order Bags.
- The active RDD determines the Order capacity of an Order Bag. The default DBFNTX and the DBFNDX drivers only support single-Order Bags, while other RDDs may support multiple-Order Bags (e.g., the DBFCDX and DBPX drivers).
- Note: RDD suppliers may define specific behaviors for this command.
- Warning! ORDDESTROY() is not supported for DBFNDX and DBFNTX.
- Examples
- This example demonstrates ORDDESTROY() with the FoxPro driver,
- DBFCDX:
- USE Customer VIA "DBFCDX" NEW
- SET INDEX TO Customer, CustTemp
- ORDDESTROY( "CuAcct", "Customer" )
- Tests
- Status
Started
- Compliance
- See Also