summaryrefslogtreecommitdiffstats
path: root/tcl8.6/doc/break.n
diff options
context:
space:
mode:
authorWilliam Joye <wjoye@cfa.harvard.edu>2019-04-22 15:47:07 (GMT)
committerWilliam Joye <wjoye@cfa.harvard.edu>2019-04-22 15:47:07 (GMT)
commitb195c291bad9f664e91ed5458ca45561c67874a5 (patch)
treee2072eea51f523a4f4de726a92e8dcf741c14337 /tcl8.6/doc/break.n
parent7e8909a08b8e425eeaa69085cbe86e848f2f5650 (diff)
downloadblt-b195c291bad9f664e91ed5458ca45561c67874a5.zip
blt-b195c291bad9f664e91ed5458ca45561c67874a5.tar.gz
blt-b195c291bad9f664e91ed5458ca45561c67874a5.tar.bz2
backout tcl/tk 8.6.9
Diffstat (limited to 'tcl8.6/doc/break.n')
-rw-r--r--tcl8.6/doc/break.n47
1 files changed, 47 insertions, 0 deletions
diff --git a/tcl8.6/doc/break.n b/tcl8.6/doc/break.n
new file mode 100644
index 0000000..3e4ce5f
--- /dev/null
+++ b/tcl8.6/doc/break.n
@@ -0,0 +1,47 @@
+'\"
+'\" Copyright (c) 1993-1994 The Regents of the University of California.
+'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
+'\"
+'\" See the file "license.terms" for information on usage and redistribution
+'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
+'\"
+.TH break n "" Tcl "Tcl Built-In Commands"
+.so man.macros
+.BS
+'\" Note: do not modify the .SH NAME line immediately below!
+.SH NAME
+break \- Abort looping command
+.SH SYNOPSIS
+\fBbreak\fR
+.BE
+.SH DESCRIPTION
+.PP
+This command is typically invoked inside the body of a looping command
+such as \fBfor\fR or \fBforeach\fR or \fBwhile\fR.
+It returns a 3 (\fBTCL_BREAK\fR) 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 \fBcatch\fR command, Tk event bindings, and the outermost
+scripts of procedure bodies.
+.SH EXAMPLE
+.PP
+Print a line for each of the integers from 0 to 5:
+.PP
+.CS
+for {set x 0} {$x<10} {incr x} {
+ if {$x > 5} {
+ \fBbreak\fR
+ }
+ puts "x is $x"
+}
+.CE
+.SH "SEE ALSO"
+catch(n), continue(n), for(n), foreach(n), return(n), while(n)
+.SH KEYWORDS
+abort, break, loop
+'\" Local Variables:
+'\" mode: nroff
+'\" End: