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