_retds()
 Post a date return value using a date string
------------------------------------------------------------------------------
 C Prototype

     #include "extend.api"
     void _retds(
                  char far * fpString
                )

 Arguments

     fpString is a far pointer to a null-terminated string representing
     the date value to be returned.  The date string must have the form
     yyyymmdd.

 Returns

     _retds() has no return value.

 Description

     _retds() posts a date value into CA-Clipper's return value area.  When
     your Extend routine returns control to the calling CA-Clipper program,
     the posted value becomes the CA-Clipper return value of your Extend
     routine.

     _retds() converts the supplied string into a CA-Clipper date value.  If
     you supply a string that does not represent a valid date, a blank date
     value will be stored.

     Note:  _retds() converts the supplied string to a date value.  The
     string need not be preserved after the call to _retds().

 Examples

     .  From C:

        _retds("19991231");

     .  From Assembly language:

        EXTRN __retds:FAR
              mov   dx, seg MyString     ; pass address of string
                                         ; (creation of string not shown)
              push  dx
              mov   ax, offset MyString
              push  ax
              call  __retds
              add   sp, 4

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