Vely logo install | documentation | examples | changelog
16.10.0 released May 10, 2023

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.
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
// use file named "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)

Copyright (c) 2017-2023 Dasoftver LLC