DELVAR Procedure

Deletes variables and their symbols from $MAIN$, the main program level of PV-WAVE.

DELVAR, var₁, ... ,var_n

var_i One or more named variables to be deleted.

All If specified, deletes all variables and their symbols on the main program level.

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.

This example creates three variables of differing type and structure, then deletes them using DELVAR.

a = FINDGEN(3)

; Create a single-precision, floating-point vector, a.

b = {structb, field1:1.0, field2:[5, 6, 7], $

field3:"pv-wave"}

; Create an anonymous structure, b.

c = 6L

; Create a longword scalar, c.

INFO, a, b, c
A FLOAT = Array(3)
B STRUCT = - STRUCTB Array(1)
C LONG = 6
DELVAR, a, c

; Delete variables a and c.

INFO, a, b, c
A UNDEFINED = Undefined
B STRUCT = - STRUCTB Array(1)
C UNDEFINED = Undefined
DELVAR, b

; Delete variable b.

INFO, a, b, c
A UNDEFINED = Undefined
B UNDEFINED = Undefined
C UNDEFINED = Undefined

DELFUNC, DELPROC, DELSTRUCT

For more information on releasing memory to the operating system, see the PV-WAVE Programmer's Guide.