exponenta event banner

fgetl (серийный)

(Подлежит удалению) Считывание строки текста ASCII с устройства и отбрасывание терминатора

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

Синтаксис

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

Описание

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

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

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

Примеры

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

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

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

s.BytesAvailable
ans =
    17

Использовать fgetl для считывания данных, возвращенных предыдущей операцией записи, и отбрасывания признака конца.

settings = fgetl(s)
settings =
9600;0;0;NONE;LF
length(settings)
ans =
    16

Разъединить s из области и удалить s из памяти и рабочей области.

fclose(s)
delete(s)
clear s

Совет

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

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

ValuesReceived значение свойства увеличивается на количество считываемых значений, включая признак конца, каждый раз fgetl выдается.

Примечание

Нельзя использовать значения ASCII длиной более 127 символов. Функция ограничена 127 двоичными символами.

Правила выполнения операции чтения с помощью fgetl

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

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

  • Время, указанное Timeout проходит свойство.

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

Примечание

Нельзя использовать значения ASCII длиной более 127 символов. Функция ограничена 127 двоичными символами.

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

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

Не рекомендуется начинать с R2019b

См. также

Функции

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