Instrument Control Toolbox

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.

Remarks

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, then the connection is automatically broken. You can also disconnect obj from the instrument with the fclose function.

Example

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
  

See Also

Functions

clear, fclose, instrhelp, isvalid, stopasync

Properties

Status

clrdevice

disp