> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Bash Break Statement
The `break` statement is a shell builtin command used to prematurely terminate the execution of an enclosing `for`, `while`, `until`, or `select` loop. When evaluated, it immediately halts the loop's execution cycle and transfers control flow to the command immediately following the terminated loop structure.
## Syntax
```bash theme={"dark"}
break [n]
```
## Parameters
* **`n` (Optional):** An integer literal (>= 1) specifying the number of nested loop levels to exit.
* If omitted, `n` defaults to `1`, terminating only the innermost enclosing loop.
* If `n` is greater than the current depth of nested loops, `break` terminates all enclosing loops and transfers control to the statement following the outermost loop.
## Execution Mechanics
1. **Scope:** `break` only applies to loop constructs. It does not terminate functions, scripts, or subshells (which require `return` or `exit`). While frequently nested inside conditional statements (`if` or `case`), `break` ignores these structures when calculating the depth `n` and only counts the enclosing loops.
2. **Exit Status:** The return status of the `break` command is `0` (success), unless the provided argument `n` is not an integer greater than or equal to `1`.
3. **Control Transfer:** Any commands remaining in the current loop iteration after the `break` statement are bypassed.
## Syntax Visualization
**Single Loop Termination (`break` or `break 1`)**
```bash theme={"dark"}
for i in 1 2 3; do
echo "Starting iteration $i"
if [ "$i" -eq 2 ]; then
break
fi
echo "Finishing iteration $i" # Bypassed when i=2
done
echo "Control flow resumes here immediately after break"
```
**Nested Loop Termination (`break n`)**
```bash theme={"dark"}
for outer_var in 1 2; do
for inner_var in A B; do
echo "Outer: $outer_var, Inner: $inner_var"
if [ "$outer_var" -eq 1 ] && [ "$inner_var" = "A" ]; then
break 2 # Terminates both the inner and outer loops
fi
echo "Inner loop continuation" # Bypassed when break 2 is evaluated
done
echo "Outer loop continuation" # Bypassed when break 2 is evaluated
done
echo "Control flow resumes here immediately after break 2"
```
Tired of Poor Bash Skills? Fix That With Deep Grasping!
Learn More
