uniq-file
Purpose: Create a new empty file with a unique name.
uniq-file [ define ] <file name> [ temporary ]
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. <file name> is
allocated memory.
If string variable <file name> does not exist, it can be created with "define" clause. 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 define mydoc
write-file mydoc from "some data"
To create a temporary file:
uniq-file define temp_file temporary
...
"temp_file"
..
delete-file temp_file
See also
Files (
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)