ORDDESTROY()

Remove an Order from an Order Bag

Syntax

ORDDESTROY(<cOrderName> [, <cOrderBagName> ]) --> NIL

Arguments

<cOrderName> Name of the order to remove

<cOrderBagName> Name of the order bag from which order id to be removed

Returns

ORDDESTROY() always returns NIL.

Description

This function attempts to remove the order named <cOrderName> from the file containing the order bag name <cOrderBagName>. If <cOrderBagName> is not specified,then the name of the file will be based on the value of the ORDNAME() function.If the extension is not included with the name of the order file,then the extension will be obtained from the default extension of the current and active RDD.

The DBFNTX driver do not support multiple order bags;therefore,there cannot be an order to "destroy" from a bag.This function only works for those drivers with support multiple orders bags (e.q. DBFCDX and RDDADS drivers).
Examples
      USE TEsts VIA "DBFCDX" NEW
      ORDdestroy( "lName", "tests" )
Tests
      See examples
Status

Started

Compliance

This function is Ca-Clipper compliant

Platforms

All

Files

Library is rdd

See Also