instrfindall

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

Синтаксис

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

Аргументы

'P1'

Имя инструментального свойства объекта свойства объекта или группы устройств

V1

Значение допускало соответствующий P1.

s

Структура имен свойства и значений свойств.

objs

Массив инструментальных объектов или объектов группы устройств.

out

Массив возвращенных инструментальных объектов или объектов группы устройств.

Описание

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');
g1 = gpib('mcc',0,2);
g1.ObjectVisibility = 'off'

Поскольку объект g1 имеет его ObjectVisibility установите на прочь, это не отображается к командам как instrfind:

instrfind

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

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

instrfindall

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

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

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

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

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

Советы

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

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

Например, instrfindall найдет объект с Parity значение свойства Even или even. Можно использовать propinfo функция, чтобы определить, имеет ли свойство конечное множество значений вектора символов.

Примечание

Чтобы получить список опций, можно использовать на функции, нажать клавишу Tab после ввода функции на командной строке MATLAB®. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой функции завершения вкладки "Дополнительно" смотрите Используя Заполнение клавишей Tab для Функций.

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

| |

Представлено до R2006a