NAME
       time - Time the execution of a script

SYNOPSIS
       time script ?count?


DESCRIPTION
       This  command  will  call  the  Tcl interpreter count times to evaluate
       script (or once if count isn't  specified).   It  will  then  return  a
       string  of  the form 503 microseconds per iteration which indicates the
       average amount of time required per iteration, in  microseconds.   Time
       is measured in elapsed time, not CPU time.

EXAMPLE
       Estimate  how  long  it  takes  for a simple Tcl for loop to count to a
       thousand: time {
           for {set i 0} {$i<1000} {incr i} {
               # empty body
           } }


SEE ALSO
       clock(n)


KEYWORDS
