[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
 fieldName()
 Determine the name associated with a column (field) number
------------------------------------------------------------------------------
 Prototype
     ERRCODE fieldName(
                          AREAP wa,
                          USHORT fieldNum,
                          BYTEP name
                         )
 Arguments
     wa is a pointer to self.
     fieldNum specifies the ordinal position of the column whose name is
     to be obtained.
     name is a pointer to a buffer used to store the field name.
 Description
     fieldName() obtains the symbolic name associated with column fieldNum.
 Default Behavior
     fieldName() copies the name element of the symbol from the wa->lpFields
     structure at fieldNum into name.  Since fieldNum is the one-based
     CA-Clipper fieldNum column (field) number, we must subtract one to
     correctly reference the C (zero-based) column array.
     Warning!  The character buffer referenced by name must be allocated
     to at least 11 bytes prior to calling this method.
 Implementation Notes
     .  If you choose to reimplement this method in your subclass, you
        must adhere to the CA-Clipper-based symbol type.  That is, symbols
        that represent fields in work areas must be 10 or fewer characters in
        length.
 Files  Header file is Rdd.api.
See Also:
AREA
fieldCount()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson