Programmer Guide/Command Reference/DELETE

DELETE

DELETE itemname1 [ itemname2 ... ] [ /S ]

Delete the specified shell item itemname. Some types of shell items (e.g. SPU items) cannot be deleted while they are active. If a display item is deleted, all items contained in the display are removed too (i.e. graphs and dialogs items). If a dialog item contained in a 'dialog only' display item is deleted, the display item is also removed. If a DDE-conversation item (DDEConv) is removed, the conversation is ended before the item is deleted.

itemname

The name of the shell item to delete.

/S

If specified, DELETE will generate a warning rather than an error if arguments are missing or it is unable delete the arguments.

/V

If specified, the itemname is interpreted as the name of a variable, The contents of the variable are assumed to be shell items, and they are deleted. The variable is then reset to empty.

// create a table item called "hugoItem"
#hugo := new table hugoItem     // now, "#hugo" will contain the string "hugoItem"
delete /Var #hugo                       // table item "hugoItem" will be deleted *and* "#hugo" will be cleared