Arduino:Справочник языка Arduino/Библиотеки/Stream/readBytes(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 5: Строка 5:
=Функция readBytes<ref>[https://www.arduino.cc/en/Reference/StreamReadBytes readBytes()]</ref>=
=Функция readBytes<ref>[https://www.arduino.cc/en/Reference/StreamReadBytes readBytes()]</ref>=


Считывает символы из потока в буфер. Завершает свою работу, если сосчитает данные заданной длины или если выйдет время. Время устанавливается функцией setTimeout.
Считывает символы из потока в буфер. Завершает свою работу, если сосчитает данные заданной длины или если выйдет время. Время устанавливается функцией [[Arduino:Справочник языка Arduino/Библиотеки/Stream/setTimeout()|setTimeout()]].


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


Эта функция является частью [[Arduino:Справочник языка Arduino/Библиотеки/Stream|класса Stream]], и ее можно вызвать любым классом, который наследует от [[Arduino:Справочник языка Arduino/Библиотеки/Stream|Stream]] (вроде [[Arduino:Справочник языка Arduino/Библиотеки/Wire|Wire]], [[Arduino:Справочник языка Arduino/Библиотеки/Serial|Serial]] и т.д.). Более подробно об этом можно прочесть на [[Arduino:Справочник_языка_Arduino/Функции/Функции_передачи_данных/Stream|странице о классе Stream]].
Эта функция является частью [[Arduino:Справочник языка Arduino/Библиотеки/Stream|класса Stream]], и ее можно вызвать любым [[класс]]ом, который наследует от [[Arduino:Справочник языка Arduino/Библиотеки/Stream|Stream]] (вроде [[Arduino:Справочник языка Arduino/Библиотеки/Wire|Wire]], [[Arduino:Справочник языка Arduino/Библиотеки/Serial|Serial]] и т.д.). Более подробно об этом можно прочесть на [[Arduino:Справочник_языка_Arduino/Функции/Функции_передачи_данных/Stream|странице о классе Stream]].


==Синтаксис==
==Синтаксис==

Версия от 21:28, 17 февраля 2023

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


Функция readBytes[1]

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

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

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

Синтаксис

Stream.readBytes(buffer, length)

Параметры

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

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

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

См.также

  1. Stream

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