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

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

\subsection while-description Description
The <tt>while</tt> builtin causes fish to continually execute CONDITION and
execute COMMANDS as long as CONDITION returned with status 0. If CONDITION is
false on the first time, COMMANDS will not be executed at all. Hints: 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>

causes fish to print the line 'file exists' at 10 second intervals as long as
the file foo.txt exists.