(Чтобы быть удаленным) Прочитанная строка текста от инструмента и терминатора строки отбрасывания
Этот serial, Bluetooth, tcpip, udp, visa, и gpib объектная функция будет удалена в будущем релизе. Использование serialport, bluetooth, tcpclient, tcpserver, udpport, и visadev возразите функциям вместо этого. Для получения дополнительной информации см. Вопросы совместимости.
tline = fgetl(obj)
[tline,count] = fgetl(obj)
[tline,count,msg] = fgetl(obj)
[tline,count,msg,datagramaddress,datagramport]
= fgetl(obj)
| Интерфейсный объект. |
| Текст считан из инструмента, исключая терминатор строки. |
| Количество чтения значений, включая терминатор строки. |
| Сообщение, указывающее, была ли операция чтения неудачна. |
| Дейтаграммный адрес. |
| Дейтаграммный порт. |
tline = fgetl(obj) читает одну строку текста от инструмента, соединенного с obj, и возвращает данные в tline. Возвращенные данные не включают терминатор строки с текстовой строкой. Чтобы включать терминатор строки, использовать fgets.
[tline,count] = fgetl(obj) возвращает количество чтения значений к count.
[tline,count,msg] = fgetl(obj) возвращает предупреждающее сообщение в msg если операция чтения была неудачна.
[tline,count,msg,datagramaddress,datagramport]
= fgetl(obj) возвращает удаленный адрес и порт от который порожденная дейтаграмма. Эти значения возвращены только если obj объект UDP.
Создайте объект GPIB g, соедините g к Tektronix® Осциллограф TDS 210, сконфигурируйте g завершать операции чтения, когда Конец символа строки читается и пишет *IDN? команда с fprintf функция. *IDN? дает осциллографу команду возвращать идентификационную информацию.
g = gpib('ni',0,1);
fopen(g)
g.EOSMode = 'read';
fprintf(g,'*IDN?')Асинхронно считайте идентификационную информацию из инструмента.
readasync(g)
g.BytesAvailable
ans =
56Используйте fgetl передавать данные от входного буфера до MATLAB® рабочая область и отбрасывание терминатор строки.
idn = fgetl(g)
idn =
TEKTRONIX,TDS 210,0,CF:91.1CT FV:v1.16 TDS2CM:CMV:v1.04
length(idn)
ans =
55Отключите g от осциллографа, и удаляют g из памяти и рабочей области.
fclose(g) delete(g) clear g
Прежде чем можно будет считать текст из инструмента, он должен быть соединен с obj с fopen функция. Связанный интерфейсный объект имеет Status значение свойства open. Ошибка возвращена, при попытке выполнить операцию чтения в то время как obj не соединяется с инструментом.
Если msg не включен как выходной аргумент, и операция чтения не была успешна, затем предупреждающее сообщение возвращено в командную строку.
ValuesReceived значение свойства увеличено на количество чтения значений — включая терминатор строки — каждый раз fgetl выпущен.
Примечание
Вы не можете использовать значения ASCII, больше, чем 127 символов. Функция ограничивается 127 бинарными символами.
Примечание
Чтобы получить список опций, можно использовать на функции, нажать клавишу Tab после ввода функции на командной строке MATLAB. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой функции завершения вкладки "Дополнительно" смотрите Используя Заполнение клавишей Tab для Функций.
Операция чтения с fgetl блокирует доступ к командному окну MATLAB до
Терминатор строки читается. Для последовательного порта, TCPIP, UDP и последовательных ВИЗОЙ объектов, терминатор строки дан Terminator свойство. Обратите внимание на то, что для объектов UDP, DatagramTerminateMode должен быть off.
Для всех других интерфейсных объектов кроме VISA-RSIB терминатор строки дан EOSCharCode свойство.
Линия EOI утверждается (только GPIB и инструменты VXI).
Дейтаграмма была получена (объекты UDP, только если DatagramTerminateMode on).
Время задано Timeout передачи свойства.
Входной буфер заполнен.
Примечание
Вы не можете использовать значения ASCII, больше, чем 127 символов. Функция ограничивается 127 бинарными символами.
EOSCharCode значение свойства распознано только когда EOSMode свойство сконфигурировано к read или read&write. Например, если EOSMode сконфигурирован к read и EOSCharCode сконфигурирован к LF, затем один из способов, которыми завершает работу операция чтения, - когда символ перевода строки получен.
Если EOSMode none или write, затем нет никакого терминатора строки, заданного для операций чтения. В этом случае, fgetl завершит выполнение и возвратит управление в командную строку, когда другому критерию, такому как тайм-аут, будут соответствовать.
BytesAvailable | EOSCharCode | EOSMode | InputBufferSize | Status | Terminator | Timeout | ValuesReceived