instrfindall

Найдите видимые и скрытые объекты последовательного порта

Синтаксис

out = instrfindall
out = instrfindall('P1',V1,...)
out = instrfindall(s)
out = instrfindall(objs,'P1',V1,...)

Описание

out = instrfindall находит все объекты последовательного порта, независимо от значения свойства ObjectVisibility объекта. Объект или объекты возвращены в out.

out = instrfindall('P1',V1,...) возвращает массив, out, объектов последовательного порта, имена свойства которых и соответствующие значения свойств совпадают с заданными в качестве аргументов.

out = instrfindall(s) возвращает массив, out, объектов последовательного порта, имена свойства которых и соответствующие значения свойств совпадают с заданными в структуре s, где имена полей соответствуют именам свойства, и значения полей соответствуют текущему значению соответствующего свойства.

out = instrfindall(objs,'P1',V1,...) ограничивает поиск объектов с соответствием с именем свойства / пары значения к объектам последовательного порта, перечисленным в objs.

Обратите внимание на то, что можно использовать пары имени/значения свойства свойства строки, структуры и имя свойства массива ячеек / пары значения свойства в том же вызове instrfindall.

Примеры

Предположим, что вы создаете следующие объекты последовательного порта на платформе Windows®:

s1 = serial('COM1');
s2 = serial('COM2');
set(s2,'ObjectVisibility','off')

Поскольку объекту s2 установили его ObjectVisibility на 'off', это не видимо к командам как instrfind:

instrfind
   Serial Port Object : Serial-COM1

Однако instrfindall находит все объекты независимо от значения ObjectVisibility:

instrfindall
	Instrument Object Array
	Index:   Type:          Status:     Name:  
	1        serial         closed      Serial-COM1
	2        serial         closed      Serial-COM2

Следующие операторы используют instrfindall, чтобы возвратить объекты с определенными настройками свойства, которые передаются как массивы ячеек:

props = {'PrimaryAddress','SecondaryAddress};
vals = {2,0};
obj = instrfindall(props,vals);

Можно использовать instrfindall в качестве аргумента когда это необходимо, чтобы применить команду ко всем объектам, видимым и невидимым. Например, следующий оператор делает все объекты видимыми:

set(instrfindall,'ObjectVisibility','on')

Советы

instrfindall отличается от instrfind, в котором он находит объекты, свойство ObjectVisibility которых установлено в off.

Значения свойств являются чувствительными к регистру. Необходимо задать значения свойств с помощью того же формата в качестве возвращенного функцией get. Например, если get возвратит значение свойства Name как 'MyObject', instrfindall не найдет объект со значением свойства Name 'myobject'. Однако дело обстоит не так для свойств, которые имеют конечное множество значений строки. Например, instrfindall найдет объект со значением свойства Parity 'Even' или 'even'.

Смотрите также

| |