break(3tcl)

Usage

break

Overview

This command is typically invoked inside the body of a looping command such as for or foreach or while. It returns a 3 (TCL_BREAK) result code, which causes a break exception to occur. The exception causes the current script to be aborted out to the innermost containing loop command, which then aborts its execution and returns normally. Break exceptions are also handled in a few other situations, such as the catch command, Tk event bindings, and the outermost scripts of procedure bodies.

Examples

Print a line for each of the integers from 0 to 5:

for {set x 0} {$x<10} {incr x} {
    if {$x > 5} {
        break
    }
    puts "x is $x"
}

Keywords

abort, break, loop

Releases

18 releases since Debian 1.1 (Buzz); the text changed 8 times.

Referred to by

for(3tcl) 'For' loop lmap(3tcl) Iterate over all elements in one or more lists and collect results catch(3tcl) Evaluate script and trap exceptional returns subst(3tcl) Perform backslash, command, and variable substitutions while(3tcl) Execute script repeatedly as long as a condition is met return(3tcl) Return from a procedure, or set return code of a script foreach(3tcl) Iterate over all elements in one or more lists continue(3tcl) Skip to the next iteration of a loop