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