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 для Функций.

Смотрите также

| | | | |

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