Programmer Guide/Command Reference/UNIQUE: Difference between revisions
From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import) |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
<var>var</var> := UNIQUE <var>dir</var> <var>ext</var> <var>mode</var> <var>digits</var> [ <var>offset</var> ] | |||
<code> | The {{STx}} command <code>UNIQUE</code> returns a unique filename for the specified directory (use "<code>*</code>" for the current working directory). If a directory other than "<code>*</code>" is specified, it is made the current working directory first. | ||
The unique filename will be returned without its path prefix and without an extension. If, for one reason or the other, {{STX}} should be unable to create a unique filename, it will return the empty string. | |||
;<var>dir</var> | ;<var>dir</var> | ||
:The name of directory or "<code>*</code>" for the current working directory. | |||
:The name of directory or | |||
;<var>ext</var> | ;<var>ext</var> | ||
:The filename extension. | |||
:The | |||
;<var>mode</var> | ;<var>mode</var> | ||
:When supplying <code>0</code> for the <var>mode</var> argument, {{Stx}} will generate the filename by using an internal decimal counter. When, on the other hand, supplying <code>1</code> for <var>mode</var>, {{STX}} will use a hexadecimal random number. | |||
:<code>0</code> | |||
;<var>digits</var> | ;<var>digits</var> | ||
:The number of digits to use in the unique filename. | |||
:The number of filename | |||
;<var>offset</var> | ;<var>offset</var> | ||
:The first index (for counter mode only). | |||
:The first index (for | |||
Latest revision as of 14:48, 7 May 2014
var := UNIQUE dir ext mode digits [ offset ]
The STx command UNIQUE returns a unique filename for the specified directory (use "*" for the current working directory). If a directory other than "*" is specified, it is made the current working directory first.
The unique filename will be returned without its path prefix and without an extension. If, for one reason or the other, STx should be unable to create a unique filename, it will return the empty string.
- dir
- The name of directory or "
*" for the current working directory. - ext
- The filename extension.
- mode
- When supplying
0for the mode argument, STx will generate the filename by using an internal decimal counter. When, on the other hand, supplying1for mode, STx will use a hexadecimal random number. - digits
- The number of digits to use in the unique filename.
- offset
- The first index (for counter mode only).
