2006-10-31 23:23:16 +08:00
|
|
|
\section if if - conditionally execute a command
|
2005-09-20 21:31:55 +08:00
|
|
|
|
|
|
|
|
\subsection if-synopsis Synopsis
|
2006-09-19 22:52:03 +08:00
|
|
|
<tt>if CONDITION; COMMANDS_TRUE...; [else; COMMANDS_FALSE...;] end</tt>
|
2005-09-20 21:31:55 +08:00
|
|
|
|
|
|
|
|
\subsection if-description Description
|
2006-11-02 21:47:25 +08:00
|
|
|
|
2006-11-11 18:52:08 +08:00
|
|
|
<tt>if</tt> will execute the command CONDITION. If the condition's
|
|
|
|
|
exit status is 0, the commands COMMANDS_TRUE will execute. If the
|
|
|
|
|
exit status is not 0 and <tt>else</tt> is given, COMMANDS_FALSE will
|
|
|
|
|
be executed.
|
|
|
|
|
|
|
|
|
|
In order to use the exit status of mutiple commands as the condition
|
|
|
|
|
of an if block, use <a href="#begin"><tt>begin; ...; end</tt></a> and
|
|
|
|
|
the short circut commands <a href="commands.html#and">and</a> and <a
|
|
|
|
|
href="commands.html#or">or</a>.
|
2005-09-20 21:31:55 +08:00
|
|
|
|
2006-11-02 21:47:25 +08:00
|
|
|
The exit status of the last foreground command to exit can always be
|
|
|
|
|
accessed using the <a href="index.html#variables-status">$status</a>
|
|
|
|
|
variable.
|
|
|
|
|
|
2005-09-20 21:31:55 +08:00
|
|
|
\subsection if-example Example
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
if test -f foo.txt
|
|
|
|
|
echo foo.txt exists
|
|
|
|
|
else
|
|
|
|
|
echo foo.txt does not exist
|
|
|
|
|
end
|
|
|
|
|
</pre>
|
|
|
|
|
will print <tt>foo.txt exists</tt> if the file foo.txt
|
|
|
|
|
exists and is a regular file, otherwise it will print
|
|
|
|
|
<tt>foo.txt does not exist</tt>.
|
