_pards()
 Retrieve a date parameter as a string
------------------------------------------------------------------------------
 C Prototype

     #include "extend.api"
     char * _pards(
                    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

     _pards() returns a far pointer to a series of bytes representing the
     date value.

 Description

     _pards() retrieves a date value passed as a parameter from CA-Clipper,
     converts it to a null-terminated character string of the form yyyymmdd,
     and returns a far pointer to that string.

     Note:  _pards() uses a single statically allocated buffer to contain
     the string representation of the date value.  Each call to _pards()
     overwrites this buffer.  If your Extend function must access more than
     one date, you should preserve the string value before calling _pards()
     again.

 Examples

     .  From C:

        char *str;
        str = _pards(1);

     .  From Assembly language:

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

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