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