OLDPWD (path)

Return the home directory for the current session user

Description

OLDPWD return the previous directory.

This variable exists to support POSIX, however the idiomatic way to access this same data is via $PWDHIST.

This is a reserved variable so it cannot be changed.

Detail

Comparison With PWDHIST

PWDHIST is an array that holds the entire PWD history rather than just the previously accessed path.

OLDPWD reads PWDHIST, so if PWDHIST is overwritten, this will affect the value of OLDPWD as well.

Error Handling

If a previous directory cannot be determined, then OLDPWD will error. For example:

» cd $OLDPWD
Error in `cd` (0,1): cannot assign value to $OLDPWD: already at oldest entry in $PWDHIST
                   > Expression: cd $OLDPWD
                   >           :          ^
                   > Character : 9

See Also


This document was generated from gen/variables/OLDPWD_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 Nov 23 00:50:15 UTC 2024 against commit 69c17da69c17da3bd9db98ca508f6a03a402f074ee24cec.

Current version is 6.4.0375 (develop) which has been verified against tests cases.