Найдите видимые и скрытые инструментальные объекты
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'); 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 для Функций.