fish-shell/doc_src/if.txt

\section if if - conditionally execute a command

\subsection if-synopsis Synopsis
<tt>if CONDITION; COMMANDS_TRUE...; [else if CONDITION2; COMMANDS_TRUE2...;] [else; COMMANDS_FALSE...;] end</tt>

\subsection if-description Description

<tt>if</tt> will execute the command \c CONDITION. If the condition's
exit status is 0, the commands \c COMMANDS_TRUE will execute.  If the
exit status is not 0 and <tt>else</tt> is given, \c COMMANDS_FALSE will
be executed.

In order to use the exit status of multiple commands as the condition
of an if block, use <a href="#begin"><tt>begin; ...; end</tt></a> and
the short circuit commands <a href="commands.html#and"><tt>and</tt></a>
and <a href="commands.html#or"><tt>or</tt></a>.

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.

\subsection if-example Example

<pre>
if test -f foo.txt
	echo foo.txt exists
else if test -f bar.txt
	echo bar.txt exists
else
	echo foo.txt and bar.txt do 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>bar.txt exists</tt> if the file bar.txt exists
and is a regular file, otherwise it will print
<tt>foo.txt and bar.txt do not exist</tt>.
Fix casing and other minor issues in documentation darcs-hash:20061031152316-ac50b-e68db9853d6e9461a0c054f1ea290704ccfc0a31.gz 2006-10-31 15:23:16 +00:00			`\section if if - conditionally execute a command`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
			`\subsection if-synopsis Synopsis`
Changed "elseif" to "else if" 2012-09-03 20:24:01 +00:00			`<tt>if CONDITION; COMMANDS_TRUE...; [else if CONDITION2; COMMANDS_TRUE2...;] [else; COMMANDS_FALSE...;] end</tt>`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
			`\subsection if-description Description`
Updates to the documentation - add a few crossreferences, remove redundant listing of builtins and update the todo list darcs-hash:20061102134725-ac50b-802d5cf8754ff94c4cc9533b2ff16a759e9aa2c9.gz 2006-11-02 13:47:25 +00:00
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 07:56:01 +00:00			`<tt>if</tt> will execute the command \c CONDITION. If the condition's`
			`exit status is 0, the commands \c COMMANDS_TRUE will execute. If the`
			`exit status is not 0 and <tt>else</tt> is given, \c COMMANDS_FALSE will`
remove trialing spaces #2 2010-09-18 02:18:26 +00:00			`be executed.`
Documentation updates darcs-hash:20061111105208-ac50b-27e335ba701b021d3119206e91d68c8504d45c2b.gz 2006-11-11 10:52:08 +00:00
Spelling fixes from Chris Rebert darcs-hash:20070801173524-ac50b-760d9ddf0e68aa24cd570b542824a7f2b3248ff5.gz 2007-08-01 17:35:24 +00:00			`In order to use the exit status of multiple commands as the condition`
Documentation updates darcs-hash:20061111105208-ac50b-27e335ba701b021d3119206e91d68c8504d45c2b.gz 2006-11-11 10:52:08 +00:00			`of an if block, use <a href="#begin"><tt>begin; ...; end</tt></a> and`
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 07:56:01 +00:00			`the short circuit commands <a href="commands.html#and"><tt>and</tt></a>`
			`and <a href="commands.html#or"><tt>or</tt></a>.`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
Updates to the documentation - add a few crossreferences, remove redundant listing of builtins and update the todo list darcs-hash:20061102134725-ac50b-802d5cf8754ff94c4cc9533b2ff16a759e9aa2c9.gz 2006-11-02 13:47:25 +00: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.`

Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00			`\subsection if-example Example`

			`<pre>`
			`if test -f foo.txt`
			`echo foo.txt exists`
Changed "elseif" to "else if" 2012-09-03 20:24:01 +00:00			`else if test -f bar.txt`
Improve documentation and error reporting for elseif. 2012-09-01 09:14:13 +00:00			`echo bar.txt exists`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00			`else`
Improve documentation and error reporting for elseif. 2012-09-01 09:14:13 +00:00			`echo foo.txt and bar.txt do not exist`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00			`end`
Improve documentation and error reporting for elseif. 2012-09-01 09:14:13 +00:00			`</pre>will print <tt>foo.txt exists</tt> if the file foo.txt`
remove trialing spaces #2 2010-09-18 02:18:26 +00:00			`exists and is a regular file, otherwise it will print`
Improve documentation and error reporting for elseif. 2012-09-01 09:14:13 +00:00			`<tt>bar.txt exists</tt> if the file bar.txt exists`
			`and is a regular file, otherwise it will print`
			`<tt>foo.txt and bar.txt do not exist</tt>.`