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.