547
VIN( ) / VIS( ) Functions
Obtain Value of Variable
Formats
1. Get Numeric Value: VIN(string$[,ERR=stmtref])
2. Get Numeric From Composite: VIN(composite$,var_1$[[,subscr]]=expr[, ... n])
3. Get String Value: VIS(string$[,ERR=stmtref])
4. Get String From Composite: VIS(composite$,var_1$[[,subscr]]=expr[, ... n])
5. VIS( ) as Record Prefix: REC=VIS(string$[,ERR=stmtref])
Where:
composite$ String variable which has been defined as a composite string.
string
String expression containing the name of a variable to be used.
stmtref
Program line number or label to transfer control to.
[,subscr]
Optional subscript(s) of a variable in the composite string. String
expression. You can include from 1 to 3 optional numeric expressions
in square brackets, comma-separated, as subscripts for the variable.
var_1$
String expression containing the name of a variable in the composite
to var_2$
string.
Note: You can use the optional ERR=stmtref with each of the syntax formats
described. The inner set of brackets enclosing [,subscr] are part of the syntax.
Returns
Contents (value) of variable(s), numeric or string.
Description
The VIN( ) function returns the numeric value (contents) of a variable where the
name of the numeric variable is stored in a string variable. The VIS( ) function
returns the string value (contents) of a string variable whose name is stored in a
string variable.
Format 1: Get Numeric Value
VIN(string$[,ERR=stmtref])
The VIN( ) function returns the numeric contents of a numeric variable whose
variable name is stored in string$.
Format 2: Get Numeric From Composite
VIN(composite$,var_1$[[,subscr]]=expr[, ... n])
The VIN( ) function returns the value contained in each numeric variable you name
(where the variable is part of a composite string). You can choose to specify up to
three subscripts for the variable.