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