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