Библиотека FatFS: f_write | file-systems

Функция f_write записывает данные в файл.

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

Параметры

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

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

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_INVALID_OBJECT, FR_TIMEOUT

Описание

Указатель чтения/записи в файловом объекте увеличивается на количество записанных байт. После завершения функции значение *ByteWritten должно быть проверено, чтобы обнаружить переполнение диска. В случае, если *ByteWritten < ByteToWrite, то это означает что во время операции записи произошло переполнение тома. Функция может подождать некоторое время при переполнении диска или закрыть файл.

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

Функция доступна, когда _FS_READONLY == 0.

См. также

f_open, f_read, f_putc, f_puts, f_printf, f_close, FIL

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