Library: File system utilities (OMVFS) Import: omvfs.xmd

Declaration

export external function change-directory
                value string path
        on      value directory on-dir optional

Argument definitions

path

The directory to change to, as an absolute path or a path relative to the current working directory.

on-dir

An existing vfs.directory object. If this parameter is specified, the directory of the vfs.directory object is changed, not the current working directory. If this parameter is specified, the path parameter must be specified as a relative or absolute URL.

You can use vfs.change-directory to change the current working directory.

  import "omvfs.xmd" prefixed by vfs.
  
  process
    vfs.change-directory "myPrograms\"

Exceptions

The following exceptions may occur:

• VFS001 The requested function is not supported for the type of connection
• VFS004 The specified path name exceeds system length limits
• VFS100 The VFS directory object must be connected before it can be used
• VFS105 The specified path is not a valid absolute or relative path
• VFS111 The specified URL contains invalid encoding
• VFS300 Generic operating system error exception
• VFS301 The specified directory does not exist

Related Syntax    vfs.connect    vfs.connect-directory    vfs.disconnect    vfs.make-directory    vfs.delete-directory    vfs.copy    vfs.move    vfs.directory-name    vfs.open    vfs.file-directory    vfs.directory

Other Library Functions    vfs.change-directory    vfs.change-owner    vfs.change-permissions    vfs.close    vfs.connect    vfs.connect-directory    vfs.copy    vfs.cursor-position    vfs.default-certificates-file    vfs.delete-directory    vfs.delete-file    vfs.describe    vfs.describe-file    vfs.directory    vfs.directory-name    vfs.disconnect    vfs.file    vfs.file-directory    vfs.file-name    vfs.link    vfs.list    vfs.lock    vfs.make-directory    vfs.move    vfs.move-cursor    vfs.omvfs-version    vfs.open    vfs.open-file-system    vfs.open-ftp    vfs.open-http    vfs.open-https    vfs.reader    vfs.set-default-certificates-file    vfs.truncate    vfs.unlock    vfs.writer

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]