SAVEARRAY
— Save data from
an array variable to a file.
Syntax:
SAVEARRAY
/O /P /Q /X:
m,
n /Y:
m,
n /Z:
m,
n /W:
m,
n
arrayname
filename
/O | the command may overwrite an existing file |
/P | save a partial array as if it were the whole thing; only useful with /X: /Y: /Z: /W: |
/Q | quietly |
/X: m, n | save only X index m through n |
/Y: m, n | save only Y index m through n |
/Z: m, n | save only Z index m through n |
/W: m, n | save only W index m through n |
arrayname | an array variable name |
filename | the file to create |
The arrayname should begin with a letter. It should contain only letters, digits, underscores, and dollar signs; it should not be more than 31 characters long.
All non-empty elements in the array will be saved. You can restore the data
later with LOADARRAY
.
The default behavior is to save the entire array. You can restrict the
elements saved using the /X:
, /Y:
, /Z:
,
and /W:
options. /X:
restricts the first dimension
of the array, /Y:
affects the second, /Z:
the third,
and /Z:
the fourth.
• Note: The maximum size for any element in the array is 8,191 characters. Longer elements may cause issues!
• Note: This command is not available in TCC/LE, in 4NT, or in older versions of TCC which don’t support array variables.
See also: the LOADARRAY
command.