ORDBAGNAME()
Return the Order Bag name of a specific Order
- Syntax
- ORDBAGNAME(<nOrder> | <cOrderName>) --> cOrderBagName
- Arguments
- <nOrder> is an integer that identifies the position in the Order List of the target Order whose Order Bag name is sought.
- <cOrderName> is a character string that represents the name of the target Order whose Order Bag name is sought.
- Returns
- ORDBAGNAME() returns a character string, the Order Bag name of the specific Order.
- Description
- ORDBAGNAME() is an Order management function that lets you access the name of the Order Bag in which resides. You may identify the Order as a character string or with an integer that represents its position in the Order List. In case of duplicate names, ORDBAGNAME() only recognizes the first matching name.
- Examples
- The following example uses ORDBAGNAME() with the default
- DBFNTX driver:
- USE Customer VIA "DBFNTX" NEW
- SET INDEX TO CuAcct, CuName, CuZip
- ORDBAGNAME( 2 ) // Returns: CuName
- ORDBAGNAME( 1 ) // Returns: CuAcct
- ORDBAGNAME( 3 ) // Returns: CuZip
- In this example, Customer.cdx contains three orders named
- CuAcct, CuName, CuZip:
- USE Customer VIA "DBFCDX" NEW
- SET INDEX TO Customer
- ORDBAGNAME( "CuAcct" ) // Returns: Customer
- ORDBAGNAME( "CuName" ) // Returns: Customer
- ORDBAGNAME( "CuZip" ) // Returns: Customer
- Status
Started
- Compliance
- See Also