os.Path.chvolume

This method is not supported and returns a failure. Please, use the os.Path.chdir method, instead.

When the os.Path.chdir method is used, the current volume is changed automatically.

The method can be used on Windows OS only.

os.Path.chvolume() is used to change the current working volume.

CALL os.Path.chvolume(new_volume) RETURNING result

where:

new_volume is a STRING variable standing for the volume to select as a current one,
result is an INTEGER variable returning TRUE when the working volume can be successfully changed and FALSE otherwise.

Here is an example of the method calling:

#changes the current working volume to "C:\"

CALL os.Path.chvolume("C:\\") RETURNING result

As the backslash symbol is a default escape symbol which makes the compiler treat the symbol following it as a literal character and ignore its special functionality, to add a backslash symbol to a character string you have to use a double backslash in the source code or four symbols in a row to add a double backslash:

DISPLAY "This is a backslash: \\"

DISPLAY "This is a double backslash: \\\\"