Macro Command Help

VARLOAD

 

Macro Command Name

Menu Path

Link to Command Table
VARLOAD

Access via macro or menu only

Click here

 

Introduction

Notes

Example

Introduction

Reads substitution variables from a file.

How to use

The variables read from file are added to the current list if the parameter MERGE equals 1, otherwise any current variables are erased. VARLOAD will, (by default) load all substitution variables, but will allow a named set of variables only to be loaded or merged from the file.

Notes

Format:
!VARLOAD <file>[,@MERGE=<merge>] [,@DESC=$dname#][ ,$name# ...]

where:  

  • <file> is a system file path name up to 56 chars long.

  • If the parameter "MERGE" is not specified, or <merge> is zero, all current variables are erased.

  • If <merge> is 1, any variable that already exists in memory is updated with the file value, and new variables are added to those in memory.

  • Both <file> and <merge> may be substitution variables.

  • The description supplied when the file was created can optionally be restored into a supplied variable <$dname>.

  • If the optional list of variables is given, only these variables are considered; otherwise all variables are loaded. The list may be extended onto as many lines as necessary; continuation is implied by ending the previous line with a comma.

Example

!varload \Studio 3\projects\$proj, merge=1 , $title1#, $title2#, $xmin#, $xmax#, $ymin#, $ymax#