[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _itemType()
 Determine an item's type
------------------------------------------------------------------------------
 C Prototype

     #include "item.api"
     USHORT _itemType(
                       ITEM itmRef
                     )

 Arguments

     itmRef is the item whose type you want to determine.

 Returns

     One of a number of manifest constants that indicate the item's
     CA-Clipper type, as shown in the following section.

 Description

     The _itemType() function is used to determine an item's CA-Clipper type.
     The returned type corresponds to the table below:

     Item Type Manifest Constants from Extend.api
     ------------------------------------------------------------------------
     Manifest Constant       CA-Clipper Type
     ------------------------------------------------------------------------
     UNDEF                   NIL or simply undefined
     CHARACTER               Character string
     NUMERIC                 Numeric (long or double)
     LOGICAL                 Boolean value
     DATE                    Date value
     MPTR                    Item is passed by reference
     MEMO                    Memo field
     ARRAY                   CA-Clipper-level array
     BLOCK                   Code block
     DOUBLE                  Double numeric
     ------------------------------------------------------------------------

     These constants do not distinctly represent CA-Clipper types.  Numeric
     values are divided into word and double, and system-defined objects as
     well as object type (classname) are not determinable.  CA-Clipper-level
     objects are identified as arrays by the Item API.

     Note:  Computer Associates does not recommend use of the Item API to
     modify object values, as such modifications would violate an object's
     interface and encapsulation.

     An item's _itemType() may be a combination of manifest constants from
     the list above.  For example, an item may be a character string passed
     by reference.  In this case, the flags CHARACTER and MPTR would be set.
     A call to _itemType() for a numeric such as 42.102 would set both
     NUMERIC and DOUBLE flags.  To test for multiple flags, simply OR them
     together (e.g., CHARACTER | MPTR).

 Files  Library is CLIPPER.LIB, header file is Item.api.


See Also: _itemSize()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson