GOLF(2gg)

NAME
uniq-file - (files)

PURPOSE
Create a new empty file with a unique name.

SYNTAX

        uniq-file <file name> [ temporary ]

DESCRIPTION
One of the common tasks in many applications is creating a unique file (of any kind, including temporary). uniq-file statement does that - it creates a new unique file of zero size, with <file name> being its fully qualified name, which is always within the file-storage.

The file itself is created empty. If "temporary" clause is used, then the file created is a temporary-file.

The file has no extension. You can rename it after it has been created to reflect its usage or purpose.

All files created are setup with owner and group read/write only permissions.

EXAMPLES
The following creates an empty file with auto-generated name that will be stored in "mydoc" variable. String variable "mydoc" is defined in the statement. The string "some data" is written to a newly created file:

        uniq-file mydoc
        write-file mydoc from "some data"

To create a temporary file:

        uniq-file temp_file temporary
        ...
        // use file named "temp_file"
        ..
        delete-file temp_file

SEE ALSO
 Files

change-mode close-file copy-file delete-file file-position file-storage file-uploading lock-file open-file read-file read-line rename-file stat-file temporary-file uniq-file unlock-file write-file See all documentation