ERASE

Erases an HDS object

Description:

This routine erases a specified HDS object or container file. If the object is a structure, then all the structure’s components (and sub-components, etc.) are also erased. If a slice or cell of an array is specified, then the entire array is erased.

Usage:

erase object

Parameters:

OBJECT = UNIV (Write)
The HDS object or container file to be erased.
OK = _LOGICAL (Read)
This parameter is used to seek confirmation before an object is erased. If a TRUE value is given, then the HDS object will be erased. If a FALSE value is given, then the object will not be erased and a message will be issued to this effect.
REPORT = _LOGICAL (Read)
This parameter controls what happens if the named OBJECT does not exist. If TRUE, an error is reported. Otherwise no error is reported. [TRUE]

Examples:

erase horse
This erases the HDS container file called horse.sdf.
erase fig123.axis
This erases the AXIS  component of the HDS file called fig123.sdf. If AXIS is a structure, all its components are erased too.
erase fig123.axis(1).label
This erases the LABEL  component within the first element of the AXIS structure of the HDS file called fig123.sdf.
erase $AGI_USER/agi_restar.agi_3200_1
This erases the AGIDEV_3200_1 structure of the HDS file called
$AGI_USER/agi_restar.sdf.

Related Applications

FIGARO: CREOBJ, DELOBJ, RENOBJ.