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 Tue Dec 10 22:56:57 UTC 2024 against commit 60f05a260f05a227caf73dd5b3478e3cb3f4bb24e46745b.

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