External Interfaces Reference |
Return serial port objects from memory to the MATLAB workspace
Syntax
out = instrfind out = instrfind('PropertyName
',PropertyValue,...) out = instrfind(S) out = instrfind(obj,'PropertyName
',PropertyValue,...)
Arguments
' PropertyName ' |
A property name for obj . |
PropertyValue |
A property value supported by PropertyName . |
S |
A structure of property names and property values. |
obj |
A serial port object, or an array of serial port objects. |
out |
An array of serial port objects. |
Description
out = instrfind
returns all valid serial port objects as an array to out
.
out = instrfind('
returns an array of serial port objects whose property names and property values match those specified.PropertyName
',PropertyValue,...)
out = instrfind(S)
returns an array of serial port objects whose property names and property values match those defined in the structure S
. The field names of S
are the property names, while the field values are the associated property values.
out = instrfind(obj,'
restricts the search for matching property name/property value pairs to the serial port objects listed in PropertyName
',PropertyValue,...)
obj
.
Remarks
Refer to Displaying Property Names and Property Values for a list of serial port object properties that you can use with instrfind
.
You must specify property values using the same format as the get
function returns. For example, if get
returns the Name
property value as MyObject
, instrfind
will not find an object with a Name
property value of myobject
. However, this is not the case for properties that have a finite set of string values. For example, instrfind
will find an object with a Parity
property value of Even
or even
.
You can use property name/property value string pairs, structures, and cell array pairs in the same call to instrfind
.
Example
Suppose you create the following two serial port objects.
You can use instrfind
to return serial port objects based on property values.
You can also use instrfind
to return cleared serial port objects to the MATLAB workspace.
clear s1 s2 newobjs = instrfind Instrument Object Array Index: Type: Status: Name: 1 serial open Serial-COM1 2 serial open Serial-COM2
Functions
instrcallback | isvalid |
© 1994-2005 The MathWorks, Inc.