exponenta event banner

instrfind

Считывание объектов приборов из памяти в рабочее пространство MATLAB

Синтаксис

out = instrfind
out = instrfind('PropertyName',PropertyValue,...)
out = instrfind(S)
out = instrfind(obj,'PropertyName',PropertyValue,...)

Аргументы

'PropertyName'

Имя свойства для obj.

PropertyValue

Значение свойства, поддерживаемое PropertyName.

S

Структура имен свойств и их значений.

obj

Объект инструмента или массив объектов инструмента.

out

Массив объектов приборов.

Описание

out = instrfind возвращает все допустимые объекты инструмента в виде массива для out.

out = instrfind('PropertyName',PropertyValue,...) возвращает массив объектов-приборов, имена и значения свойств которых соответствуют указанным.

out = instrfind(S) возвращает массив объектов-инструментов, имена и значения свойств которых совпадают с определенными в структуре S. Имена полей S являются именами свойств, в то время как значения полей являются связанными значениями свойств.

out = instrfind(obj,'PropertyName',PropertyValue,...) ограничивает поиск совпадающих пар имя/значение свойства объектами инструмента, перечисленными в obj.

Примеры

Предположим, что создаются следующие два объекта GPIB.

g1 = gpib('ni',0,1);
g2 = gpib('ni',0,2);
g2.EOSCharCode = 'CR';
fopen([g1 g2])

Вы можете использовать instrfind для возврата объектов инструмента на основе значений свойств.

out1 = instrfind('Type','gpib');
out2 = instrfind({'Type','EOSCharCode'},{'gpib','CR'});

Также можно использовать instrfind для возврата очищенных объектов инструмента в рабочее пространство MATLAB ®.

clear g1 g2
newobjs = instrfind

Instrument Object Array
   Index:   Type:          Status:     Name:  
   1        gpib           open        GPIB0-1
   2        gpib           open        GPIB0-2

Присвойте объектам прибора их исходные имена.

g1 = newobjs(1);
g2 = newobjs(2);

Закрыть оба g1 и g2.

fclose(newobjs)

Совет

instrfind не вернет объект прибора, если ObjectVisibility свойство настроено на off.

Необходимо указать значения свойств, используя свойство того же формата, что и требуется. Например, если Name значение свойства указано как MyObject, instrfind не найдет объект с Name значение свойства myobject. Однако это не относится к свойствам, имеющим конечный набор значений символьных векторов. Например, instrfind найдет объект с Parity значение свойства Even или even. Вы можете использовать propinfo чтобы определить, имеет ли свойство конечное множество значений символьных векторов.

Если требуется очистить все объекты, найденные с помощью instrfind, вы можете использовать instrreset функция.

В одном вызове для можно использовать пары векторов, структуры и пары массивов ячеек имени свойства/значения свойства instrfind.

Примечание

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

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