aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/while.txt
blob: 496c36c22baed595f9d3066aa13b1df9cbdee1c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
\section while while - perform a command multiple times

\subsection while-synopsis Synopsis
<tt>while CONDITION; COMMANDS...; end</tt>

\subsection while-description Description
<tt>while</tt> repeatedly executes <tt>CONDITION</tt>, and if the exit status
is 0, then executes <tt>COMMANDS</tt>.

If the exit status of \c CONDITION is non-zero on the first iteration,
\c COMMANDS will not be executed at all.

Use <a href="#begin"><tt>begin; ...; end</tt></a> for complex conditions; more
complex control can be achieved with <tt>while true</tt> containing a
<a href="#break">break</a>.

\subsection while-example Example

<tt>while test -f foo.txt; echo file exists; sleep 10; end</tt>
outputs 'file exists' at 10 second intervals as long as
the file foo.txt exists.