Запись текста в инструмент и чтение данных с инструмента
out = query(obj,'cmd')
out = query(obj,'cmd','wformat
')
out = query(obj,'cmd','wformat
','rformat
')
[out,count] = query(...)
[out,count,msg] = query(...)
[out,count,msg,datagramaddress,datagramport]
= query(...)
| Объект интерфейса. |
| Строка, которая записывается в инструмент. |
| Формат для письменных данных. |
| Формат для чтения данных. |
| Содержит данные, считанные с прибора. |
| Количество считанных значений. |
| Сообщение, указывающее, была ли операция чтения неудачной. |
| Адрес дейтаграммы. |
| Порт датаграммы. |
out = query(obj,'cmd')
записывает строку cmd
с прибором, соединенным с obj
. Данные, считанные с прибора, возвращаются в out
. По умолчанию в %s\n
формат используется для cmd
, и %c
формат используется для возвращенных данных.
out = query(obj,'cmd','
записывает строку wformat
') cmd
использование формата, заданного wformat
.
wformat
является спецификацией преобразования языка C. Спецификации преобразования включают в себя %
символ и конверсионные символы d, я, o, u, x, X, f, e, E, g, G, c, и s. Обратитесь к sprintf
спецификации формата ввода-вывода файла или руководство на C для получения дополнительной информации.
out = query(obj,'cmd','
записывает строку wformat
','rformat
')cmd
использование формата, заданного wformat
. Данные, считанные с прибора, возвращаются в out
использование формата, заданного rformat
.
rformat
является спецификацией преобразования языка C. Поддерживаемые спецификации преобразования идентичны поддерживаемым wformat
.
[out,count] = query(...)
возвращает количество значений, считанных в count
.
[out,count,msg] = query(...)
возвращает предупреждающее сообщение в msg
если операция чтения не завершилась успешно.
[out,count,msg,datagramaddress,datagramport]
= query(...)
возвращает удаленный адрес и порт, от которого произошла дейтаграмма. Эти значения возвращаются только при использовании объекта UDP.
Этот пример создает объект GPIB g
, соединяет g
в Tektronix® Осциллограф TDS 210, записывает и считывает текстовые данные с помощью query
, а затем отключает g
от прибора.
g = gpib('ni',0,1); fopen(g) idn = query(g,'*IDN?') idn = TEKTRONIX,TDS 210,0,CF:91.1CT FV:v1.16 TDS2CM:CMV:v1.04 fclose(g)
Прежде чем вы сможете записать или считать данные, obj
должен быть подключен к прибору с fopen
функция. Связанный объект интерфейса имеет Status
значение свойства open
. Ошибка возвращается при попытке выполнить операцию запроса во время obj
не соединяется с прибором.
query
действует только в синхронном режиме и блокирует командную строку до завершения выполнения записи и чтения.
Используя query
эквивалентно использованию fprintf
и fgets
функций. Правила завершения операции записи описаны в fprintf
страницы с описанием. Правила завершения операции чтения описаны в fgets
страницы с описанием.
Примечание
Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции на MATLAB® командная строка. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой расширенной функции заполнения клавишей Tab, смотрите Использование заполнения клавишей Tab для функций.