Main Content

delete

Remove instrument objects from memory

Syntax

delete(obj)

Arguments

obj

An instrument object or an array of instrument objects.

Description

delete(obj) removes obj from memory.

Examples

This example creates the GPIB object g, connects g to the instrument, writes and reads text data, disconnects g, removes g from memory using delete, and then removes g from the workspace using clear.

g = gpib('ni',0,1);
fopen(g)
fprintf(g,'*IDN?')
idn = fscanf(g);
fclose(g)
delete(g)
clear g

Tips

When you delete obj, it becomes an invalid object. Because you cannot connect an invalid object to the instrument, you should remove it from the workspace with the clear command. If multiple references to obj exist in the workspace, then deleting one reference invalidates the remaining references.

If obj is connected to the instrument, it has a Status property value of open. If you issue delete while obj is connected, the connection is automatically broken. You can also disconnect obj from the instrument with the fclose function.

If obj is an interface object that is associated with a device object, the device object is automatically deleted when obj is deleted. However, if obj is a device object, the interface object is not automatically deleted when obj is deleted.

Version History

Introduced before R2006a