|Dir.Change||Part 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" else 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.