12-54
Creating A Script File
PARSE
Syntax: PARSE <string> <variable1> <key> <variable2>
This command enables you parse a string using a specified key (e.g. a single
character or a string of characters), where
<string> is the string or variable containing the string to be parsed.
<variable#> are two previously defined string variables (see var) into which
characters from the string will be placed.
<key> is a single character or a string of characters which signifies that all
following characters in the string are to be placed in the second
variable.
If the string contains the key, then all the characters preceding the first instance of the
key will be placed in the string variable specified by <variable1>, and all following
characters will be placed in the second variable. If the key is not found in the string,
then all the characters will be placed in the first variable.
Refer to the Error Numbers section later in this chapter for a list of possible error
numbers for this command.
PASSWORD
Syntax: PASSWORD <title> <caption> <entry> [<x> <y>]
This command enables you to display a simple dialog box for password entry where
keyboard entered text is displayed as asterisks. The box will have a specified title,
contain two buttons (Ok and Cancel) and a single line text box with a specified
prompt. The command parameters are as follows:
<title> is the text to be displayed in the title bar of the dialog box, as specified
by a string delimited by double quotes or the name of a previously
defined string variable (see var).
<caption> is the text that will appear to the left or above the text box, as specified
by a string delimited by double quotes or the name of a previously
defined string variable.
<entry> is a previously defined string variable which is used to store the text
entered in the text box by the user, but only if the Ok button is pressed,
otherwise the variable is set to NULL.
<x> <y> specify the horizontal and vertical position of the top left corner of the
dialog box in relation to the top left corner of the screen in pixels.
These can be integers or variables.
The following example will display a dialog box with the title Password containing a
text box with the prompt Enter your password:, and cause the text entered in the