time(1T)						       Tcl Built-In Commands							  time(1T)

__________________________________________________________________________________________________________________________________________________

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(1T)

KEYWORDS

       script, time

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tcl is available on http://opensolaris.org.

Tcl																	  time(1T)