Seth Woolley's Man Viewer

while(n) - while, while - Execute script repeatedly as long as a condition is met - man n while

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

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



NAME
       while - Execute script repeatedly as long as a condition is met

SYNOPSIS
       while test body


DESCRIPTION
       The while command evaluates test as an expression (in(1,8) the same way that
       expr(1,3,n) evaluates its argument).  The  value  of  the  expression  must  a
       proper  boolean  value;  if(3,n) it is a true value then body is executed by
       passing it to the Tcl interpreter.  Once body has  been  executed  then
       test  is evaluated again, and the process repeats until eventually test
       evaluates to a false boolean value.  Continue commands may be  executed
       inside  body  to terminate the current iteration of the loop, and break
       commands may be executed inside body to cause immediate termination  of
       the while command.  The while command always returns an empty string.

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


SEE ALSO
       break(n), continue(n), for(n), foreach(n)


KEYWORDS
       boolean value, loop, test, while



Tcl                                                                   while(n)

References for this manual (incoming links)