HP Business BASIC/XL Reference Manual - HP 3000 MPE/iX Computer Systems - Edition 1 (32715-90001)

4-: 119
READ FORM
The READ FORM statement assigns the values entered into the fields of a
VPLUS form to HP Business BASIC/XL variables. A time limit for input can
be specified by using the TIMEOUT clause.
Syntax
READ [FROM] FORM
[ [{,} ]]
[ form_item [{;} form_item ...]]
[{,} ]
[{;} TIMEOUT [=] time_expr ]
[{,} ]
[{;} NOEDIT [[=] key_number_list ]]
Parameters
form_item One of the following:
form_element
for_clause
skip_clause
form_element One of the following:
num_var
str_var $
array_name ([*[,*]...])
str_array_name $([*[,*]...])
The last two formats above have one asterisk per
dimension or does not use asterisks. Not using
asterisks specifies any number of dimensions. Either
format is legal, but the format without asterisks is not
compilable. Substrings are also allowed.
for_clause (FOR num_var = num_expr1 TO num_expr2 [STEP num_expr3 ],
form_item [, form_item ]...)
A for_clause is useful for reading array elements.
Refer to the INPUT statement for more information.
skip_clause SKIP skip_expr
A skip_clause is used to skip one or more fields in the
form to avoid the necessity of assigning them. The
skip_expr is a numeric expression that evaluates to the
number of fields to skip.
time_expr Time_expr is a numeric expression that evaluates to the
number of seconds that you have to fill in any input
fields on the form. You must depress the ENTER key or a
user-defined branch-during-input key before this time or
an HP Business BASIC/XL error occurs. Under the latter
conditions, no input is assigned to the form
variable(s).
key_number_list A list of integers or numeric expressions that evaluate
to an integer in the range of [1..8] separated by commas
or semicolons. No more than 8 values can be specified
for each statement. If the integer is not in the
specified range, an error occurs. If you do not specify
values, all keys do not have editing completed.
The READ FORM statement is terminated by pressing the ENTER key or a