$SYMBOL string function $SYMBOL string function Syntax $SYMBOL (pointer) Function Determine the user symbol that is referenced by a pointer previously obtained with the SYMBOL.PTR real-valued function. Usage Considerations The pointer value must have been obtained with the SYMBOL.PTR real-valued function. Parameter pointer Real variable that identifies the symbol to be referenced. Details This function can be used to determine the user symbol (that is, program or variable name) that is pointed to by a pointer previously determined with the SYMBOL.PTR real-valued function.
A null string is returned if the pointer value is zero or invalid, or if the symbol has been deleted since the pointer was defined. Example After the SYMBOL.PTR function has been used to set the values of elements of the array my.pgm.ptr[ ] (for example, see the dictionary page for the CALLP instruction), the following instruction can be used to display the program name that is referenced by one of the pointers: TYPE "Program", index, " is ", $SYMBOL(my.pgm.ptr[index]) Related Keyword CALLP program instruction SYMBOL.PTR real-valued function eV+Language Reference Guide, v2.x, 18319-000 Rev A Page 517