queries and/or sets the current working directory - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : System : External Functions : currentdir

currentdir - queries and/or sets the current working directory

Calling Sequence

currentdir()

currentdir(target)

Parameters

target

-

string or symbol; directory to be set as current directory

sym

-

symbol; one of

Description

• 

If called with no arguments, currentdir returns the current working directory as a Maple string.

• 

If called with one argument target, currentdir sets the current working directory to the specified directory.  The currentdir command returns the previous working directory as a Maple string.

• 

If the specified directory does not exist, or cannot be accessed for some other reason, currentdir will generate an error.

• 

If target is a string; it is interpreted as be a path to the new directory.

• 

If target is one of the symbols bindir, datadir, homedir, mapledir, or toolboxdir; it is interpreted as referring to the associated directory specified by the kernelopts command. For example, currentdir(mapledir) sets the current directory to the directory returned by kernelopts(mapledir).

Details

• 

The set of characters that are permitted in directory names is system dependent. Likewise, the character used to separate the components of a directory is system dependent. If the backslash character is to appear in the string, it must be doubled up, since Maple strings use the backslash character as an escape character.

• 

Changing the current directory does not affect library paths that were specified in a relative way on the Maple command line; all such library paths become fully qualified, that is, absolute when Maple starts. However, library paths specified subsequently (that is, by assignment to libname) may become invalid if they were relative, and the current directory is later changed.

• 

The current directory is not affected by the restart command.

Current Directory Indicator in Standard Interface

• 

In the Maple Standard interface, the current directory is indicated in the status bar at the bottom of the Maple window.

• 

This indicator is a live control.  To set a new current working directory interactively through the Maple Standard interface:

1. 

Click the current directory indicator on the status bar.

2. 

Navigate to the desired new directory.

• 

For more information on the status bar, see Status Bar.

Examples

OldDirectory:=currentdir

OldDirectory:=/u/joeuser/work

(1)

currentdirhomedir

/u/joeuser/work

(2)

currentdir

/u/joeuser

(3)

currentdirOldDirectory

/u/joeuser

(4)

currentdir

/u/joeuser/work

(5)

See Also

getenv, kernelopts, libname, mkdir, restart, rmdir, worksheet/reference/statusline


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam