2005-09-20 13:31:55 +00:00
|
|
|
|
|
|
|
|
\section begin begin - Start a new block of code
|
|
|
|
|
|
|
|
|
|
\subsection begin-synopsis Synopsis
|
|
|
|
|
<tt>begin; [COMMAND;...] end </tt>
|
|
|
|
|
|
|
|
|
|
\subsection begin-description Description
|
|
|
|
|
|
|
|
|
|
The \c begin builtin is used to create a new block of code. The block
|
2006-01-23 23:17:06 +00:00
|
|
|
is unconditionally executed. Begin is equivalent to <tt>if
|
2005-09-20 13:31:55 +00:00
|
|
|
true</tt>. The begin command is used to group any number of commands
|
|
|
|
|
into a block. The reason for this is usually either to introduce a new
|
2006-01-23 23:17:06 +00:00
|
|
|
variable scope or to redirect the input to output of this set of
|
2005-09-20 13:31:55 +00:00
|
|
|
commands as a group.
|
|
|
|
|
|
2006-07-12 17:31:41 +00:00
|
|
|
The \c begin command does not change the current exit status.
|
|
|
|
|
|
2005-09-20 13:31:55 +00:00
|
|
|
\subsection begin-example Example
|
|
|
|
|
|
|
|
|
|
The following code sets a number of variables inside of a block
|
|
|
|
|
scope. Since the variables are set inside the block and have local
|
|
|
|
|
scope, they will be automatically deleted when the block ends.
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
begin
|
|
|
|
|
set -x PIRATE Yarrr
|
|
|
|
|
...
|
|
|
|
|
end
|
|
|
|
|
# This will not output anything, since PIRATE went out of scope at the end of
|
|
|
|
|
# the block and was killed
|
|
|
|
|
echo $PIRATE
|
|
|
|
|
</pre>
|
