query

Запись текста в инструмент и чтение данных с инструмента

Синтаксис

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(...)

Аргументы

obj

Объект интерфейса.

'cmd'

Строка, которая записывается в инструмент.

'wformat'

Формат для письменных данных.

'rformat'

Формат для чтения данных.

out

Содержит данные, считанные с прибора.

count

Количество считанных значений.

msg

Сообщение, указывающее, была ли операция чтения неудачной.

datagramaddress

Адрес дейтаграммы.

datagramport

Порт датаграммы.

Описание

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

Вопросы совместимости

расширить все

Не рекомендуемый запуск в R2019b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2021a

См. также

Функции

Свойства

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