База знаний / Справочник TiOS / Разработка (TiOS) / Справочник по программированию / Объекты / Объект ser. / Свойства, методы, события
Метод .getdata
| Назначение: | Для выбранного последовательного порта (выбор выполняется через ser.num) возвращает строку с данными, извлечёнными из буфера приёма (RX). |
| Синтаксис: | ser.getdata(maxinplen as word) as string |
| Возвращает: | Строку с данными, извлечёнными из буфера приёма (RX) |
| См. также: | Три режима последовательного порта, Приём данных, ser.peekdata |
| Параметр | Описание |
| maxinplen | Максимальный объём возвращаемых данных (word). |
Подробности
Извлечённые данные безвозвратно удаляются из буфера. Длина извлекаемых данных ограничена наименьшим из трёх значений: объёмом зафиксированных (committed) данных в буфере приёма (RX), ёмкостью «принимающей» строковой переменной и пределом, заданным аргументом maxinplen.
В режиме UART (ser.mode = 0 - PL_SER_MODE_UART) данные извлекаются «как есть». В режимах Wiegand и clock/data (ser.mode = 1 - PL_SER_MODE_WIEGAND и ser.mode = 2 - PL_SER_MODE_CLOCKDATA) каждый символ извлечённых данных соответствует одному биту данных, и возможны только символы «0» и «1».