Command: time
  
Syntax: 
  a = time()
  
Description: 
  Return the number of seconds since some fixed point in the past.
  
Comments: 
  Take the difference between two readings of time(), to
  measure, for example, how long a section of code takes to
  execute.
  
  The resolution with DOS32 is normally about 0.05 seconds. 
  On WIN32 it's about 0.01 seconds.
  
  Under DOS32 you can improve the resolution by calling 
  tick_rate().
  
Example: 
     constant ITERATIONS = 1000000 
       integer p
       atom t0, loop_overhead
       
       t0 = time()
       for i = 1 to ITERATIONS do
       end for
       loop_overhead = time() - t0
 
      t0 = time()
       for i = 1 to ITERATIONS do
         p = power(2, 20)
       end for
       ? (time() - t0 - loop_overhead)/ITERATIONS
       -- calculates time (in seconds) for one call to power
       
See Also: 
  date, tick_rate
  
