This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

for(n)                                      Tcl Built-In Commands                                     for(n)



____________________________________________________________________________________________________________

NAME
       for - ``For'' loop

SYNOPSIS
       for start test next body
____________________________________________________________________________________________________________


DESCRIPTION
       For  is  a  looping  command, similar in structure to the C for statement.  The start, next, and body
       arguments must be Tcl command strings, and test is an  expression  string.   The  for  command  first
       invokes the Tcl interpreter to execute start.  Then it repeatedly evaluates test as an expression; if
       the result is non-zero it invokes the Tcl interpreter on body, then invokes the  Tcl  interpreter  on
       next, then repeats the loop.  The command terminates when test evaluates to 0.  If a continue command
       is invoked within body then any remaining commands in the current execution of body are skipped; pro-cessing processing
       cessing  continues  by  invoking  the Tcl interpreter on next, then evaluating test, and so on.  If a
       break command is invoked within body or next, then the for  command  will  return  immediately.   The
       operation  of  break  and  continue are similar to the corresponding statements in C.  For returns an
       empty string.

       Note: test should almost always be enclosed in braces.  If not, variable substitutions will  be  made
       before the for command starts executing, which means that variable changes made by the loop body will
       not be considered in the expression.  This is likely to result in  an  infinite  loop.   If  test  is
       enclosed in braces, variable substitutions are delayed until the expression is evaluated (before each
       loop iteration), so changes in the variables will be visible.  For  an  example,  try  the  following
       script with and without the braces around $x<10:
              for {set x 0} {$x<10} {incr x} {
                puts "x is $x"
              }


SEE ALSO
       break, continue, foreach, while


KEYWORDS
       for, iteration, looping



Tcl                                                                                                   for(n)