# ORDNAME()

Return the name of an Order in the Order List

Syntax

  ORDNAME(<nOrder>[,<cOrderBagName> --> cOrderName

Arguments

  <nOrder> is an integer that identifies the position in the Order List of the target Order whose database name is sought.
  <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 <xcOrderBagName> HARBOUR uses the default extension of the current RDD.

Returns

  ORDNAME() returns the name of the specified Order in the current Order List or the specified Order Bag if opened in the Current Order list.

Description

  ORDNAME() is an Order management function that returns the name of the specified Order in the current Order List.
  If <cOrderBagName> is an Order Bag that has been emptied into the current Order List, only those Orders in the Order List that correspond to <cOrderBagName> Order Bag are searched.
  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).

Examples

         This example retrieves the name of an Order using its position
          in the order list:

          USE Customer NEW
          SET INDEX TO CuAcct, CuName, CuZip
          ORDNAME( 2 )                        // Returns: CuName

         This example retrieves the name of an Order given its position
          within a specific Order Bag in the Order List:

          USE Customer NEW
          SET INDEX TO Temp, Customer
          // Assume Customer contains CuAcct, CuName, CuZip
          ORDNAME( 2, "Customer" )            // Returns: CuName
    Tests

Status

  Started

Compliance

Platforms

  All

Files

  Library is rdd

See Also

- ORDFOR()
- ORDKEY()
- ORDNUMBER()