gettimer
| gettimer | 
  Purpose
 
 Get the amount of time remaining before a timer expires.
 
  Synopsis
 
 function gettimer(tid:integer):integer 
 
  Argument
 
| 
     tid 
     | 
     A timer identifier
     | 
  Return value
 
 Remaining time in milliseconds before the timer expires or
 0 if the corresponding event is already available in the queue or
 -1 if no timer corresponds to the provided identifier
  Further information
 
  This function will return
 0 if an event corresponding to the specified timer is waiting in the queue of event even if this timer has been automatically re-armed.
 
  Related topics
 
  Module
 
 
