Dir.ChangePart of Dir module

Syntax   Dir.Change (directoryPathName : string)

Description   Dir.Change changes the execution directory to that specified by the parameter directoryPathName. This is the equivalent of doing a cd in UNIX.

Under Microsoft Windows, specifying a drive in the directoryPathName parameter causes the drive to become the default drive (unlike the DOS cd command).

Details   If the Dir.Change call fails, then Error.Last will return a non-zero value indicating the reason for the failure. Error.LastMsg will return a string which contains the textual version of the error.

Example   This program changes to the directory called /usr/west and then lists the current directory.

        Dir.Change ("/usr/west")
        if Error.Last = eNoError  then
            put "Directory changed"
            put "Did not change the directory."
            put "Error: ", Error.LastMsg
        end if
        put "The current execution directory is ", Dir.Current
Example   An example demonstrating the use of several of the Dir subprograms is available. In this example, a directory is created, a file is written to the directory, an attempt is made to delete the directory, the file is deleted, and then the directory is deleted.

This example demonstrates the use of Dir.Change, Dir.Current, Dir.Create, and Dir.Delete.

Status   Exported qualified.

This means that you can only call the function by calling Dir.Change, not by calling Change.