Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

break (1t)

Name

break - Abort looping command

Synopsis

break

Description

break(1t)                    Tcl Built-In Commands                   break(1t)



______________________________________________________________________________

NAME
       break - Abort looping command

SYNOPSIS
       break
______________________________________________________________________________

DESCRIPTION
       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 proce-
       dure bodies.

EXAMPLE
       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"
              }


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tcl-8    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       catch(n), continue(n), for(n), foreach(n), return(n), while(n)

KEYWORDS
       abort, break, loop



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  http://prdownloads.sourceforge.net/tcl/tcl-
       core8.6.7-src.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tcl                                                                  break(1t)