[<<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