_itemPutDS()
 Place a date string into an item
------------------------------------------------------------------------------
 C Prototype

     #include "item.api"
     ITEM _itemPutDS(
                      ITEM itmDate,
                      BYTEP fpDate
                    )

 Arguments

     itmDate is the item into which you want to place the date string.
     If this item is NULL, a new item will be created.

     fpDate is a zero-terminated string representing the date to assign
     to the new item.  The format of fpDate must be yyyymmdd.

 Returns

     A new date item reference containing the date passed.

 Description

     The _itemPutDS() function is used to place a zero-terminated string date
     into an item.  If the date string is malformed, the new date item will
     be set to a NULL date.

     Caution!  Do not assume that the address in itmDate will be the
     same address returned by _itemPutDS().

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