Описание
Метод Stream.readBytesUntil() считывает символы из потока и помещает их в указанный буфер. Функция прекращает свою работу после обработки заданного количества символов, в случае обнаружения указанного символа, либо в случае таймаута (см. setTimeout()). Метод readBytesUntil() возвращает количество байт, помещенных в буфер, либо 0 - если таковых нет.
Данная функция является одним из методов класса Stream, поэтому вызывается любым объектом, являющимся наследником этого класса (Wire, Serial и др.). Для получения дополнительной информации см. описание класса Stream.
Синтаксис
stream.readBytesUntil(character, buffer, length);
Параметры
stream - экземпляр класса, унаследованного от Stream.
character - искомый символ (char).
buffer - буфер для хранения считываемых данных (char[] или byte[]).
length - количество символов, которое необходимо считать (int).
Возвращаемые значения
Количество байт, помещенных в буфер.
Смотрите также:
Stream
Библиотека Stream
Справочник
Материалы взяты с официального сайта проекта Arduino и представлены по лицензии Creative Commons Attribution-ShareAlike 3.0 License.
Источник: http://arduino.cc/en/Reference/StreamReadBytesUntil |