/*
   --------------------------------------------------------
   Filename....: filestamp.cc
   ClassName...: FileStamp
   Purpose.....: object to get and set file date/time attributes.
   Programmer..: Rick Miller with help from Gary White.
   Date........: May 31, 2002
   Notes.......: None.
   Written for.: dB2K 0.1 and newer.
   Rev. History: March 28, 2005  -  added getTimeSeparator for
                 compatibility as suggested by Simone Bartoccioni.
                 February 10, 2005  -  renamed all external functions.
                 July 25, 2002   -  revision to method setFilestamp
   Dependencies: None.
   Calls.......: See x_InitExterns method.
   Called by...: Any.
   Usage.......: set procedure to :dUFLP:filestamp.cc additive
   Example.....: See below.
   --------------------------------------------------------
   Example:
   --------------------------------------------------------
      oRef = new filestamp()
      oRef.set("date", date())
      oRef.set("time", time())
      oRef.set("filename", "c:\myapp\myapp.ini")
      oRef.set("filestamp")
      oRef.close()
      oRef := null
      close procedure :dUFLP:filestamp.cc
   --------------------------------------------------------
   Properties:          Default:
   --------------------------------------------------------
      filename    space(254)  drive:\path\file or UNC\file
   --------------------------------------------------------
   Keywords for get, set methods:
   --------------------------------------------------------
      date, filename, filestamp, help, time.
   --------------------------------------------------------
   Methods:
   --------------------------------------------------------
      close()     call to release
      get(<char> keyword)
         returns object property or true/false (success/fail)
      help([<char> topic])
      inspect()   display properties in the inspector.
      release()   release object from memory
      set(<char> keyword, [value])
         returns true/false (success/fail)
   */