Найти видимые и скрытые объекты инструмента
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 установите значение off, оно не отображается для таких команд, как 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, смотрите Использование заполнения клавишей Tab для функций.