query

(Чтобы быть удаленным) текст Записи к инструменту и считанные данные из инструмента

Этот serial, Bluetooth, tcpip, udp, visa, и gpib объектная функция будет удалена в будущем релизе. Использование serialport, bluetooth, tcpclient, tcpserver, udpport, и visadev возразите функциям вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Синтаксис

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

Примечание

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

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

развернуть все

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

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

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

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

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

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

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

Функции

Свойства

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