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

$DATE                                               $VERSION                                           GOLF(2gg)