delete (serial) (External Interfaces Reference)

External Interfaces Reference

delete (serial)

Remove a serial port object from memory

Syntax

```
delete(obj)
```

Arguments

obj
A serial port object or an array of serial port objects.

`obj`	A serial port object or an array of serial port objects.

Description

delete(obj) removes obj from memory.

Remarks

When you delete obj, it becomes an invalid object. Because you cannot connect an invalid serial port object to the device, 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 device, 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 device with the fclose function.

If you use the help command to display help for delete, then you need to supply the pathname shown below.

```
help serial/delete
```

Example

This example creates the serial port object s, connects s to the device, writes and reads text data, disconnects s from the device, removes s from memory using delete, and then removes s from the workspace using clear.

s = serial('COM1');
fopen(s)
fprintf(s,'*IDN?')
idn = fscanf(s);
fclose(s)
delete(s)
clear s

See Also

Functions

clear, fclose, isvalid

Properties

Status

clear (serial) disp (serial)