_parclen()
 Retrieve the length of a character parameter
------------------------------------------------------------------------------
 C Prototype

     #include "extend.api"
     unsigned int _parclen(
                            int iParamNum
                            [, int iArrayIndex]
                          )

 Arguments

     iParamNum is the one-based ordinal position of the parameter in the
     parameter list.

     iArrayIndex is an array index that specifies a particular element if
     the iParamNum parameter is an array.

 Returns

     _parclen() returns the length of the character value as an unsigned
     integer type.

 Description

     _parclen() returns the length of a character value passed as a parameter
     from CA-Clipper.  The byte containing the null terminator is not
     included in the logical length.  Embedded null bytes, however, are
     included if present.

 Examples

     .  From C:

        unsigned int len;
        len = _parclen(1);

     .  From Assembly language:

        EXTRN __parclen:FAR
              mov   ax, 1
              push  ax
              call  __parclen         ; length returned in AX
              add   sp, 2             ; reset stack pointer

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