fgets (serial)

(Чтобы быть удаленным) Прочитанная строка текста от устройства и включать терминатор строки

Этот serial объектная функция будет удалена в будущем релизе. Использование serialport возразите функциям вместо этого. См. Вопросы совместимости.

Синтаксис

tline = fgets(obj)
[tline,count] = fgets(obj)
[tline,count,msg] = fgets(obj)

Описание

tline = fgets(obj) читает одну строку текста от устройства, соединенного к объекту последовательного порта, obj, и возвращает данные в tline. Эти возвращенные данные включают терминатор строки с текстовой строкой. Чтобы исключить терминатор строки, использовать fgetl.

[tline,count] = fgets(obj) возвращает количество чтения значений к count, включая терминатор строки.

[tline,count,msg] = fgets(obj) возвращает предупреждающее сообщение в msg если операция чтения была неудачна.

Примеры

Создайте объект последовательного порта s, соедините s к осциллографу Tektronix® TDS 210 и записи RS232? команда с fprintf функция. RS232? дает осциллографу команду возвращать коммуникационные настройки последовательного порта.

s = serial('COM1');
fopen(s)
fprintf(s,'RS232?')

Поскольку значение по умолчанию для ReadAsyncMode свойством является continuous, данные автоматически возвращены во входной буфер.

s.BytesAvailable
ans =
    17

Использование fgets считывать данные, возвращенные в предыдущую операцию записи и включать терминатор строки.

settings = fgets(s)
settings =
9600;0;0;NONE;LF
length(settings)
ans =
    17

Отключите s от осциллографа, и удаляют s из памяти и рабочей области.

fclose(s)
delete(s)
clear s

Советы

Прежде чем можно будет считать текст из устройства, он должен быть соединен с obj с fopenфункция. Связанный объект последовательного порта имеет Status значение свойства open. Ошибка возвращена, при попытке выполнить операцию чтения в то время как obj не соединяется с устройством.

Если msg не включен как выходной аргумент, и операция чтения не была успешна, затем предупреждающее сообщение возвращено в командную строку.

ValuesReceived значение свойства увеличено на количество чтения значений – включая терминатор строки – каждый раз fgets выпущен.

Примечание

Вы не можете использовать значения ASCII, больше, чем 127 символов. Функция ограничивается 127 бинарными символами.

Правила для Завершения Операции чтения с fgets

Операция чтения с fgets блокирует доступ к командной строке MATLAB® до:

  • Терминатор строки задан Terminator свойство достигнуто.

  • Время задано Timeout передачи свойства.

  • Входной буфер заполнен.

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

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

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

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

Функции

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте