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

# The until loop

## Synopsis

    until <LIST1> ; do
      <LIST2>
    done

## Description

The until-loop is relatively simple in what it does: it executes the
[command list](../../syntax/basicgrammar.md#lists) `<LIST1>` and if the exit
code of it was **not** 0 (FALSE) it executes `<LIST2>`. This happens
again and again until `<LIST1>` returns TRUE.

This is exactly the opposite of the [while
loop](../../syntax/ccmd/while_loop.md).

:!: Like all loops (both `for`-loops, `while` and `until`), this loop
can be

-   terminated (broken) by the `break` command, optionally as `break N`
    to break `N` levels of nested loops
-   forced to immediately do the next iteration using the `continue`
    command, optionally as `continue N` analog to `break N`

### Return status

The return status is the one of the last command executed in `<LIST2>`,
or `0` (`TRUE`) if none was executed.

## Examples

## Portability considerations

## See also

-   Internal: [The while loop](../../syntax/ccmd/while_loop.md)
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`# The until loop`

			`## Synopsis`

			`until <LIST1> ; do`
			`<LIST2>`
			`done`

			`## Description`

			`The until-loop is relatively simple in what it does: it executes the`
Fix hyperlinks of markdown pages at depth 3 find docs/ -depth 3 -name '.md' \| xargs grep '(./' -l \| \ xargs -I{} \ sed -i '' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2.md#\3)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2/\3.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2/\3.md#\4)%g' \ -e 's%](\([^:.>)#][^:.>)#]\))%](../../\1.md)%g' \ -e 's%](\([^:.>)#][^:.>)#]\)#\([^:.>)#][^:.>)#]*\))%](../../\1.md#\2)%g' \ {} Related to https://github.com/flokoe/bash-hackers-wiki/issues/10 2024-01-29 02:07:56 +01:00			[command list](../../syntax/basicgrammar.md#lists) `<LIST1>` and if the exit
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			code of it was not 0 (FALSE) it executes `<LIST2>`. This happens
			again and again until `<LIST1>` returns TRUE.

			`This is exactly the opposite of the [while`
Fix hyperlinks of markdown pages at depth 3 find docs/ -depth 3 -name '.md' \| xargs grep '(./' -l \| \ xargs -I{} \ sed -i '' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2.md#\3)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2/\3.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2/\3.md#\4)%g' \ -e 's%](\([^:.>)#][^:.>)#]\))%](../../\1.md)%g' \ -e 's%](\([^:.>)#][^:.>)#]\)#\([^:.>)#][^:.>)#]*\))%](../../\1.md#\2)%g' \ {} Related to https://github.com/flokoe/bash-hackers-wiki/issues/10 2024-01-29 02:07:56 +01:00			`loop](../../syntax/ccmd/while_loop.md).`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			:!: Like all loops (both `for`-loops, `while` and `until`), this loop
			`can be`

			- terminated (broken) by the `break` command, optionally as `break N`
			to break `N` levels of nested loops
			- forced to immediately do the next iteration using the `continue`
			command, optionally as `continue N` analog to `break N`

			`### Return status`

			The return status is the one of the last command executed in `<LIST2>`,
			or `0` (`TRUE`) if none was executed.

			`## Examples`

			`## Portability considerations`

			`## See also`

Fix hyperlinks of markdown pages at depth 3 find docs/ -depth 3 -name '.md' \| xargs grep '(./' -l \| \ xargs -I{} \ sed -i '' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2.md#\3)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)\(.md\)\{0\})%(../../\1/\2/\3.md)%g' \ -e 's%(/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)/\([^/#).][^/#).]\)#\([a-zA-Z_-][0-9a-zA-Z_-]\))%(../../\1/\2/\3.md#\4)%g' \ -e 's%](\([^:.>)#][^:.>)#]\))%](../../\1.md)%g' \ -e 's%](\([^:.>)#][^:.>)#]\)#\([^:.>)#][^:.>)#]*\))%](../../\1.md#\2)%g' \ {} Related to https://github.com/flokoe/bash-hackers-wiki/issues/10 2024-01-29 02:07:56 +01:00			`- Internal: [The while loop](../../syntax/ccmd/while_loop.md)`