Программирование Файловые системы Библиотека FatFS: f_read Mon, October 14 2024  

Поделиться

Нашли опечатку?

Пожалуйста, сообщите об этом - просто выделите ошибочное слово или фразу и нажмите Shift Enter.

Библиотека FatFS: f_read Печать
Добавил(а) microsin   

f_read

Функция 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

[Ссылки]

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

 

Добавить комментарий


Защитный код
Обновить

Top of Page