1mNAME0m
       time - Time the execution of a script

1mSYNOPSIS0m
       1mtime 4m22mscript24m ?4mcount24m?


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

1mEXAMPLE0m
       Estimate how long it takes for a simple Tcl 1mfor  22mloop  to  count  to  a
       thousand:
              time {
                  for {set i 0} {$i<1000} {incr i} {
                      # empty body
                  }
              }


1mSEE ALSO0m
       clock(n)


1mKEYWORDS0m
