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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
м (Замена текста — «<syntaxhighlight lang="c">» на «<syntaxhighlight lang="c" enclose="div">»)
 
Нет описания правки
 
(не показано 7 промежуточных версий 2 участников)
Строка 1: Строка 1:
{{#setlogo:ArduinoCommunityLogo.png}}
{{Arduino панель перехода}}
{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Перевод от Сubewriter}}
Строка 6: Строка 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», это значит, что корректных данных найдено не было.


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


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


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Stream.readBytes(buffer, length)
Stream.readBytes(buffer, length)
</syntaxhighlight>
</syntaxhighlight>
Строка 20: Строка 19:
==Параметры==
==Параметры==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Stream — объект класса, который наследует от Stream
Stream — объект класса, который наследует от Stream
buffer — буфер, в который будут записываться данные (char[] или byte[])
buffer — буфер, в который будут записываться данные (char[] или byte[])
Строка 28: Строка 27:
==Что возвращает==
==Что возвращает==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Количество байтов, помещенных в буфер
Количество байтов, помещенных в буфер
</syntaxhighlight>
</syntaxhighlight>
Строка 34: Строка 33:
=См.также=
=См.также=


# Stream
# [[Arduino:Справочник языка Arduino/Библиотеки/Stream|Stream]]


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


<references />
<references />
{{Навигационная таблица/Портал/Arduino}}
[[Категория:Справочник языка Arduino]]
[[Категория:Справочник языка Arduino]]

Текущая версия от 11:26, 8 июля 2023

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


Функция readBytes[1]

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

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

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

Синтаксис

Stream.readBytes(buffer, length)

Параметры

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

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

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

См.также

  1. Stream

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