Arduino:Справочник языка Arduino/Библиотеки/Stream/readBytesUntil()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция readBytesUntil()[1]

Считывает байты из потока в буфер. Завершает свою работу, если сосчитает данные заданной длины, если наткнется на терминальный символ или если выйдет время. Время задается функцией setTimeout.

Возвращает информацию о количестве байтов, помещенных в буфер. Если функция возвращает «0», это значит, что корректных данных найдено не было.

Эта функция является частью класса Stream, и ее можно вызвать любым классом, который наследует от Stream (вроде Wire, Serial и т.д.). Более подробно об этом можно прочесть на странице о классе Stream.

Синтаксис

Stream.readBytesUntil(character, buffer, length)

Параметры

Stream  объект класса, который наследует от Stream
character  искомый символ (char)
buffer  буфер, в который будут записываться байты (char[] или byte[])
length  количество считанных байтов (int)

Что возвращает

Количество байтов, помещенных в буфер.

См.также

  1. Stream

Внешние ссылки