Описание

Метод объекта File считывает байт данных из открытого файла. Функция read() является наследником вспомогательного класса Stream.

Синтаксис

file.read();
file.read(buf, len);

Параметры

file - экземпляр класса FIle (возвращаемый функцией SD.open()).

buf - указатель на буфер куда будут записаны данные, тип void*

len - максимальное количество байт, которое можно считать из файла, тип unsigned int.

Возвращаемые значения

int:

• в случае вызова функции без параметров: Байт данных (или символ), либо -1, если таковых нет
• во втором случае: в случае успешного считывания данных вернется количество реально считанных байт, т.к. конец файла может быть достигнут раньше. В случае ошибки (файл не открыт, ошибка файловой системы, сброй ввода-вывода) вернется -1.

Смотрите также:

available()

peek()

write()

Stream.read()

Библиотека SD

Справочник

Материалы взяты с официального сайта проекта Arduino и представлены по лицензии Creative Commons Attribution-ShareAlike 3.0 License.