exponenta event banner

fgets (серийный)

(Подлежит удалению) Прочитайте строку текста с устройства и включите признак конца

Это 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