Standard Library procedure that pushes a directory onto the top of a last-in, first-out directory stack.

directory — A scalar string specifying the path of the new working directory.

If not specified, or if specified as a null string, pushes the current directory onto the stack, and the new working directory is changed to the user’s home directory.

None.

Directories that have been pushed onto the stack by PUSHD can be removed with POPD. The last directory pushed onto the stack is the first directory popped out of it. There is no limit to how deep directories may be stacked.

See the example for the "POPD Procedure".

CD, POPD, PRINTD