The
setvalue function executes an assignment when the name of the variable to be assigned to is not known at compilation time (when writing the application). The function searches for a variable with a name stored in the string expression
variable_name, and if such a variable is found, the function assigns to it the value stored in
value. If the variable is numeric, then
value should be a numeric expression, and if the variable is alphanumeric, then it should be a string expression. Optional arguments,
occurrence1 to
occurrence3, allow you to pass occurrence numbers to the function. This function is especially useful when combined with a
userbar button or an
OnKey character sequence.
The function returns a logical value of 1 (true) if the variable name was found and the value was successfully changed. The function returns 0 (false) if the variable was not found, if a string expression was assigned to a numeric variable, or if a numeric expression was assigned to an alphanumeric variable.