Creates a unique temporary file in the Genstat temporary folder.
No options
Parameters
PREFIX = string |
Prefix for the filename |
FILENAME = text |
Saves the filename |
INDEX = scalar |
Saves the index number that follows the prefix in the filename |
Description
%TEMPFILE
creates a unique file in the Genstat temporary folder. The location of the temporary folder can be obtained by the GETTEMPFOLDER
procedure, and is set by the %TMP%
or %TEMP%
environment variables on your computer. An empty file is created, so that other programs will not use the same name.
The PREFIX
parameter provides the text to be used at the start of the filename. The extension of the filename is always .tmp
. The unique filename is returned by the FILENAME
parameter, and the INDEX
parameter saves its index number. Note, the filename has the index value written in hexadecimal format, but the index is saved as an ordinary number. For example:
%TEMPFILE PREFIX='Out'; FILENAME=TFile; INDEX=filenumber
could return TFile
as 'C:/Temp/Genstat/Out1F.tmp'
and INDEX
as 31
(31 in hexadecimal = 1F).
The file is not deleted automatically at the end of the Genstat run. So, when you have finished using it, you need to delete it yourself (for example, with the FDELETE
directive).
Options: none.
Parameter: PREFIX
, FILENAME
, INDEX
.
See also
Directives: CLOSE
, FDELETE
, OPEN
.
Procedure: GETTEMPFOLDER
.
Commands for: Program control.