mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-11-23 21:53:09 +08:00
27 lines
826 B
Plaintext
27 lines
826 B
Plaintext
\section return return - stop the innermost currently evaluated function
|
|
|
|
\subsection return-synopsis Synopsis
|
|
<tt>function NAME; [COMMANDS...;] return [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 executing function and return to
|
|
the caller, but it can also be used to specify the exit status of a
|
|
function.
|
|
|
|
- \c STATUS is the return status of the function. If unspecified, the status is unchanged.
|
|
|
|
\subsection return-example Example
|
|
The following code is an implementation of the false command as a fish function
|
|
|
|
<pre>
|
|
function false
|
|
return 1
|
|
end
|
|
</pre>
|
|
|
|
|