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 будет задано как MyObject, instrfindall не найдет объект со значением свойства Name myobject. Однако дело обстоит не так для свойств, которые имеют конечное множество значений вектора символов.

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

Примечание

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

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

| |

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

Для просмотра документации необходимо авторизоваться на сайте