2005-09-20 13:31:55 +00:00
|
|
|
|
|
|
|
|
\section return return - Stop the innermost currently evaluated function
|
|
|
|
|
|
|
|
|
|
\subsection return-synopsis Synopsis
|
|
|
|
|
<tt>function NAME; [COMMANDS...] break [STATUS]; [COMMANDS...] end</tt>
|
|
|
|
|
|
|
|
|
|
\subsection return-description Description The \c return builtin is
|
|
|
|
|
used to halt a currently running function. 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 to conditionally stop the
|
2006-06-03 23:15:17 +00:00
|
|
|
executing function and return to the caller, but it can also be used
|
|
|
|
|
to specify the exit status of a function.
|
2005-09-20 13:31:55 +00:00
|
|
|
|
|
|
|
|
- \c STATUS is the return status of the function. If unspecified, the status is set to 0.
|
|
|
|
|
|
|
|
|
|
\subsection return-example Example
|
2006-06-03 23:15:17 +00:00
|
|
|
The following code is an implementation of the false command as a fish function
|
2005-09-20 13:31:55 +00:00
|
|
|
<p>
|
|
|
|
|
<pre>function false
|
|
|
|
|
return 1
|
|
|
|
|
end</pre>
|
|
|
|
|
</p>
|
|
|
|
|
|
