запрос

Запишите текст в инструмент и считайте данные из инструмента

Синтаксис

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, i, 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 эквивалентно использованию функции fgets и fprintf. Правила для завершения операции записи описаны на страницах с описанием fprintf. Правила для завершения операции чтения описаны на страницах с описанием fgets.

Примечание

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

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

| | |

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