bash-hackers-wiki/docs/syntax/expansion/tilde.md

---
tags:
  - bash
  - shell
  - scripting
  - expansion
  - substitution
  - tilde
  - home
  - homedir
  - shortcut
---

# Tilde expansion

    ~
    ~/...

    ~NAME
    ~NAME/...

    ~+
    ~+/...

    ~-
    ~-/...

The tilde expansion is used to expand to several specific pathnames:

-   home directories
-   current working directory
-   previous working directory

Tilde expansion is only performed, when the tilde-construct is at the
beginning of a word, or a separate word.

If there's nothing to expand, i.e., in case of a wrong username or any
other error condition, the tilde construct is not replaced, it stays
what it is.

Tilde expansion is also performed everytime a variable is assigned:

-   after the **first** `=`: `TARGET=~moonman/share`
-   after **every** `:` (colon) in the assigned value:
    `TARGET=file:~moonman/share`

!!! info "Note"
    As of now (Bash 4.3-alpha) the following constructs
    **also** works, though it's not a variable assignment:

        echo foo=~
        echo foo=:~

    I don't know yet, if this is a bug or intended.

This way you can correctly use the tilde expansion in your
[PATH](../../syntax/shellvars.md#PATH):

    PATH=~/mybins:~peter/mybins:$PATH

**Spaces in the referenced pathes?** A construct like...

    ~/"my directory"

...is perfectly valid and works!

## Home directory

    ~
    ~<NAME>

This form expands to the home-directory of the current user (`~`) or the
home directory of the given user (`~<NAME>`).

If the given user doesn't exist (or if his home directory isn't
determinable, for some reason), it doesn't expand to something else, it
stays what it is. The requested home directory is found by asking the
operating system for the associated home directory for `<NAME>`.

To find the home directory of the current user (`~`), Bash has a
precedence:

-   expand to the value of [HOME](../../syntax/shellvars.md#HOME) if it's
    defined
-   expand to the home directory of the user executing the shell
    (operating system)

That means, the variable `HOME` can override the "real" home
directory, at least regarding tilde expansion.

## Current working directory

    ~+

This expands to the value of the [PWD](../../syntax/shellvars.md#PWD) variable,
which holds the currect working directory:

    echo "CWD is $PWD"

is equivalent to (note it **must** be a separate word!):

    echo "CWD is" ~+

## Previous working directory

    ~-

This expands to the value of the [OLDPWD](../../syntax/shellvars.md#OLDPWD)
variable, which holds the previous working directory (the one before the
last `cd`). If `OLDPWD` is unset (never changed the directory), it is
not expanded.

    $ pwd
    /home/bash
    $ cd /etc
    $ echo ~-
    /home/bash

## See also

-   Internal: [Introduction to expansion and
    substitution](../../syntax/expansion/intro.md)
Fix tags 2024-04-02 21:19:20 +02:00			`---`
			`tags:`
			`- bash`
			`- shell`
			`- scripting`
			`- expansion`
			`- substitution`
			`- tilde`
			`- home`
			`- homedir`
			`- shortcut`
			`---`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
Fix tags 2024-04-02 21:19:20 +02:00			`# Tilde expansion`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			`~`
			`~/...`

			`~NAME`
			`~NAME/...`

			`~+`
			`~+/...`

			`~-`
			`~-/...`

			`The tilde expansion is used to expand to several specific pathnames:`

			`- home directories`
			`- current working directory`
			`- previous working directory`

			`Tilde expansion is only performed, when the tilde-construct is at the`
			`beginning of a word, or a separate word.`

format(docs): remove escaped 's character pairs 2024-03-30 19:22:45 +01:00			`If there's nothing to expand, i.e., in case of a wrong username or any`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`other error condition, the tilde construct is not replaced, it stays`
			`what it is.`

			`Tilde expansion is also performed everytime a variable is assigned:`

			- after the first `=`: `TARGET=~moonman/share`
			- after every `:` (colon) in the assigned value:
			`TARGET=file:~moonman/share`

Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			`!!! info "Note"`
			`As of now (Bash 4.3-alpha) the following constructs`
			`also works, though it's not a variable assignment:`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			`echo foo=~`
			`echo foo=:~`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			`I don't know yet, if this is a bug or intended.`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			`This way you can correctly use the tilde expansion in your`
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			`[PATH](../../syntax/shellvars.md#PATH):`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			`PATH=~/mybins:~peter/mybins:$PATH`

Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			`Spaces in the referenced pathes? A construct like...`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			`~/"my directory"`

Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			`...is perfectly valid and works!`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00
			`## Home directory`

			`~`
			`~<NAME>`

			This form expands to the home-directory of the current user (`~`) or the
			home directory of the given user (`~<NAME>`).

format(docs): remove escaped t's 2024-03-30 20:09:26 +01:00			`If the given user doesn't exist (or if his home directory isn't`
			`determinable, for some reason), it doesn't expand to something else, it`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`stays what it is. The requested home directory is found by asking the`
			operating system for the associated home directory for `<NAME>`.

			To find the home directory of the current user (`~`), Bash has a
			`precedence:`

format(docs): remove escaped 's character pairs 2024-03-30 19:22:45 +01:00			`- expand to the value of [HOME](../../syntax/shellvars.md#HOME) if it's`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`defined`
			`- expand to the home directory of the user executing the shell`
			`(operating system)`

Updated table formatting, call-outs, html comments, improper escapes. 2024-10-08 06:00:17 +02:00			That means, the variable `HOME` can override the "real" home
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`directory, at least regarding tilde expansion.`

			`## Current working directory`

			`~+`

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			`This expands to the value of the [PWD](../../syntax/shellvars.md#PWD) variable,`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`which holds the currect working directory:`

			`echo "CWD is $PWD"`

			`is equivalent to (note it must be a separate word!):`

			`echo "CWD is" ~+`

			`## Previous working directory`

			`~-`

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			`This expands to the value of the [OLDPWD](../../syntax/shellvars.md#OLDPWD)`
Convert syntax pages to Markdown 2023-07-05 11:43:35 +02:00			`variable, which holds the previous working directory (the one before the`
			last `cd`). If `OLDPWD` is unset (never changed the directory), it is
			`not expanded.`

			`$ pwd`
			`/home/bash`
			`$ cd /etc`
			`$ echo ~-`
			`/home/bash`

			`## See also`

			`- Internal: [Introduction to expansion and`
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			`substitution](../../syntax/expansion/intro.md)`