DELVAR Procedure
Deletes variables and their symbols from $MAIN$, the main program level of PV‑WAVE.
Usage
DELVAR, var1, ... ,varn
Input Parameters
vari — One or more named variables to be deleted.
Keywords
All — If specified, deletes all variables and their symbols on main program level.
Discussion
DELVAR may be called from any program level to delete a variable from the main program level. If DELVAR is called from the main program level, the variable is directly deleted.
When DELVAR is used to delete a local variable, the variable is also deleted from the main program level. If DELVAR is called from a procedure, one of the two following requirements applies:
UPVAR must be used to bind the local variable on the procedure level to the variable on the main program level.
The variable on the main program level must be passed as a parameter to the procedure or function from which DELVAR is called.
Example
This example creates three variables of differing type and structure, then deletes them using DELVAR.
; Create a single-precision, floating-point vector.
a = FINDGEN(3)
; Create an anonymous structure.
b = {structb, field1:1.0, field2:[5, 6, 7], field3:'PV-WAVE'}; Create a longword scalar.
c = 6L
INFO, a, b, c
; PV-WAVE prints the following:
; A FLOAT = Array(3)
; B STRUCT = -> STRUCTB Array(1)
; C LONG = 6
; Delete variables a and c.
DELVAR, a, c
INFO, a, b, c
; PV-WAVE prints the following:
; A UNDEFINED = <Undefined>
; B STRUCT = -> STRUCTB Array(1)
; C UNDEFINED = <Undefined>
; Delete variable b.
DELVAR, b
INFO, a, b, c
; PV-WAVE prints the following:
; A UNDEFINED = <Undefined>
; B UNDEFINED = <Undefined>
; C UNDEFINED = <Undefined>
See Also
For more information on releasing memory to the operating system, see the PV‑WAVE Programmer’s Guide.
Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.