Библиотека FatFS: f_read | ARM

Функция f_read читает данные из файла.

FRESULT f_read (
  FIL* FileObject,    /* Указатель на структуру файлового объекта */
  void* Buffer,       /* Буфер, куда будут сохранены данные */
  UINT ByteToRead,    /* Количество байт для чтения */
  UINT* ByteRead      /* Количество прочитанных байт */
);

Параметры

FileObject: Указатель на открытый файловый объект.
Buffer: Указатель на буфер, куда будут записаны прочитанные данные.
ByteToRead: Количество байт для чтения в диапазоне UINT.
ByteRead: Указатель на переменную типа UINT для возврата количества реально прочитанных байт (количество прочитанных байт может отличаться от количества запрошенных). Значение всегда валидно после завершения функции, независимо от её кода возврата.

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

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_INVALID_OBJECT, FR_TIMEOUT

Описание

Указатель на файловый объект увеличивается на количество прочитанных байт. После завершения функции значение *ByteRead должно быть проверено, чтобы проверить - достигнут ли конец файла. Если *ByteRead < ByteToRead, то это означает, что указатель чтения/записи файла достиг до конца файла на операции чтения.

Краткая информация (QuickInfo)

Функция доступна всегда, независомо от устанволенных опций FatFS..

См. также

f_open, f_gets, f_write, f_close, FIL

1. f_read - чтение из файла (оригинал статьи на английском языке).