Toolbox function implementation
Toolbox function implementation
The Toolbox function implementation takes place in a macro:
[MACRO tools]readvar #argv #function #argv /Dgoto cmd$#function noCmdnoCmd: exit cmdFunction1:$@TBPARSE '$#argv' // Parses the arguments depending on the context. This must be the first command$@TBLOADSETUP // Loads the settings (if any are defined)/*... the function code ...*/$@TBSAVESETUP // Save the settings (if any were changed)exit 1 int $#changed // #changed must be set to 1 if any data was changed (otherwise 0)
The function @TBPARSE must be the first command in the macro function. @TBPARSE and @TBLOADSETUP convert the calling arguments and the settings into local variables.
@TBPARSE
The Toolbox function @TBPARSE creates the following local variables:
#keyword
|
The name of the calling context. |
#function
|
The name of the function which was called. |
If a failure occurs when parsing, the Toolbox function is exited.
@TBLOADSETUP
The Toolbox function @TBLOADSETUP creates local variables for all setup variable definitions in the function definition. Every varname = varvalue entry is converted into a local variable #varname with the value varvalue. Setup variables can be saved using the Toolbox function @TBSAVESETUP. The setup variables are stored in the S_TOOLS-STx INI file.
@TBSAVESETUP
The Toolbox function @TBSAVESETUP saves all modified setup variables in the current S_TOOLS-STx INI file.
