bash-hackers-wiki/docs/syntax/ccmd/grouping_plain.md

72 lines
1.9 KiB
Markdown
Raw Normal View History

2023-07-05 11:43:35 +02:00
# Grouping commands
## Synopsis
{ <LIST>; }
{
<LIST>
}
## Description
The [list](../../syntax/basicgrammar.md#lists) `<LIST>` is simply executed in
2023-07-05 11:43:35 +02:00
the **current** shell environment. The list must be terminated with a
**newline** or **semicolon**. For parsing reasons, the curly braces must
be separated from `<LIST>` by a **semicolon** and **blanks** if they're
2023-07-05 11:43:35 +02:00
in the same line! [^1][^2]
This is known as a **group command**. The return status is the [exit
status (exit code)](../../scripting/basics.md#exit_codes) of the list.
2023-07-05 11:43:35 +02:00
The input and output **filedescriptors** are cumulative:
{
echo "PASSWD follows"
cat /etc/passwd
echo
echo "GROUPS follows"
cat /etc/group
} >output.txt
This compound command also usually is the body of a [function
definition](../../syntax/basicgrammar.md#shell_function_definitions), though not
the only compound command that's valid there:
2023-07-05 11:43:35 +02:00
print_help() {
echo "Options:"
echo "-h This help text"
echo "-f FILE Use config file FILE"
echo "-u USER Run as user USER"
}
## Examples
### A Try-Catch block
try_catch() {
{ # Try-block:
eval "$@"
} ||
{ # Catch-block:
echo "An error occurred"
return -1
}
}
## Portability considerations
## See also
* [[syntax:ccmd:grouping_subshell | grouping commands in a subshell]]
[^1]: Actually any properly terminated compound command will work
without extra separator (also in some other shells), **example**:
`{ while sleep 1; do echo ZzZzzZ; done }` is valid. But this is not
documented, infact the documentation explicitly says that a
semicolon or a newline must separate the enclosed list. -- thanks
2023-07-05 11:43:35 +02:00
`geirha` at Freenode
[^2]: The main reason is the fact that in shell grammar, the curly
braces are not control operators but reserved words -- TheBonsai