vfs.open

function

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

Returns: A VFS file object for the opened file.


Declaration
export external file function open
                value string filename
        on      value directory on-dir optional
        for     value integer access-type optional initial {read-mode}

Argument definitions

filename
The path (which may be either an URL or a local file system path) to the file to be opened.
on-dir
A connected vfs.directory object. If this parameter is specified the filename parameter is interpreted relative to the vfs.directory and must be expressed as a relative URL.
access-type
An integer constant signifying the desired mode of access. The default value is vfs.read-mode.


Purpose

You can use vfs.open to open a file. vfs.open creates a vfs.file object that represents the file, and which can be used with various OMVFS functions to manipulate the file.

You may specify the mode in which the file is opened. The default mode is read mode. The following modes are available:

Exceptions

The following exceptions may occur: