os/open

    cfunction

    (os/open path &opt flags mode)

    Create a stream from a file, like the POSIX open system call. 
    Returns a new stream. mode should be a file mode as passed to 
    os/chmod, but only if the create flag is given. The default mode is 
    8r666. Allowed flags are as follows:

    * :r - open this file for reading
    * :w - open this file for writing
    * :c - create a new file (O_CREATE)
    * :e - fail if the file exists (O_EXCL)
    * :t - shorten an existing file to length 0 (O_TRUNC)

    Posix only flags:

    * :a - append to a file (O_APPEND)
    * :x - O_SYNC
    * :C - O_NOCTTY

    Windows only flags:

    * :R - share reads (FILE_SHARE_READ)
    * :W - share writes (FILE_SHARE_WRITE)
    * :D - share deletes (FILE_SHARE_DELETE)
    * :H - FILE_ATTRIBUTE_HIDDEN
    * :O - FILE_ATTRIBUTE_READONLY
    * :F - FILE_ATTRIBUTE_OFFLINE
    * :T - FILE_ATTRIBUTE_TEMPORARY
    * :d - FILE_FLAG_DELETE_ON_CLOSE
    * :b - FILE_FLAG_NO_BUFFERING