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

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