~ Home Sigil

Home directory path variable

Description

The tilde token is used as a convenience shortcut to users home directory.

By itself, ~ will point to the current users home directory.

If a username follows, eg ~joe.bloggs, then the home directory for that user is returned irrespective of who is presently logged in. Characters supported by tilde usernames are alpha upper and lower case, numeric, underscore, full stop (period), and hyphens.

Examples

Current user

Assuming current username is “bob”:

» out ~
/home/bob

Alternative user

Assuming “joe” is a valid user on local system:

» out ~joe
/home/joe

Unhappy path

If username does not exist, ~ will default to the root path.

Assuming “foobar” isn’t a valid local user:

» out ~foobar
/

Detail

Infixing

Tilde can be expanded inside double quotes, brace quotes as well as used naked. But it cannot be expanded inside single quotes.

» out ~
/home/bob

» out '~'
~

» out "~"
/home/bob

» out %(~)
/home/bob

Error Handling

If a username is supplied that that user doesn’t exist, the tilde will raise an error. For example:

» ~joe.bloggs
Error in `expr` (0,1): cannot expand variable `~joe.bloggs`: user: unknown user joe.bloggs

See Also


This document was generated from gen/parser/variables_doc.yaml.

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Sat Aug 23 22:28:13 UTC 2025 against commit ad23f13ad23f131bfecd82ea8a12d9b3e92aab5d8398ae9.

Current version is 7.0.2129 (website) which has been verified against tests cases.