delete variable

Removes a variable contents from memory.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

delete {local | global | variable} {variableName | arrayIndex}

# Params

- variableName : The name of any local or global variable. - arrayIndex : A key of an array variable. If an arrayIndex is specified instead of a variable name, the delete variable command removes that element of the array, without deleting the rest of the elements in the array.

# Examples

local tVariable delete local tVariable

global gArray delete global gArray[17]

# Description

Use the delete variable command to free memory used by a large variable. The delete variable command only removes the contents of the variable.

If you delete a key from an array variable, that element of the array no longer exists as part of the variable.

>*Note:* local variables that are used within a > handler are automatically deleted when the handler in which they > are used exits.

# Tags

properties,

# See

- **keyword:** element - **command:** global, delete, local - **function:** globalNames - **glossary:** key, handler, variable, exit, local variable, array, command