aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/break.txt
blob: 9e5118728db86f43eea3dc365bbee5db7cebb9ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
\section break break - stop the innermost currently evaluated loop

\subsection break-synopsis Synopsis
 <tt>LOOP_CONSTRUCT; [COMMANDS...] break; [COMMANDS...] end</tt>

\subsection break-description Description
The \c break builtin is used to halt a currently running loop, such as a <a href="#for">for</a> loop or a <a href="#while">while</a> loop. It is usually added inside of a conditional block such as an <a href="#if">if</a> statement or a <a href="#switch">switch</a> statement.

\subsection break-example Example
The following code searches all .c files for smurfs, and halts at the first occurrence.

<pre>
for i in *.c
    if grep smurf $i
        echo Smurfs are present in $i
        break
    end
end
</pre>