MPE/iX Intrinsics Reference Manual (32650-90875)

326 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPCIGETVAR
NOTE If the type of variable is unknown, pass the maximum number of
itemnum,item pairs (6) and check itemnum 13 (variable type) to determine
which item holds the variable's value.
NOTE For itemnum =12, recursively dereferenced variables are always returned as
string values.
Table 7-5. HPCIGETVAR Itemnum/Item Values
Itemnum Mnemonic Item Description
0 Itemnum/item pair ignored
1 I32 Integer value of variable (output):
0 if variable is not an integer.
Default: No value returned
2 CA String value of variable (output):
An ASCII 0 is returned if the value of the variable is not a string.
Default: No value returned
3 I32 Boolean value of variable (output):
1 for a true value, 0 for a false value, 0 if variable is not a boolean.
Default: No value returned
10 I32 Length of array passed to hold variable's string value (input):
If a length is passed and an array is not, an error occurs.
Default: 255
11 I32 Actual length (in bytes) of variable's string value (output)
Default: No value returned
12 I32 Recursion used (input):
Nonzero if the variable is to be recursively dereferenced; zero if the
variable should not be recursively dereferenced (that is, it should retain
its level one value).
Default: 1 (nonzero)
13 I32 Type of variable ( varname , if found) (output) :
The variable found returns the following:
1 Integer
2 String
3 Boolean
Default: No value returned