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