Функция переименовывает файловый объект (файл или директорию).

FRESULT f_rename (
  const TCHAR* OldName, /* Указатель на старое имя объекта */
  const TCHAR* NewName  /* Указатель на новое имя объекта */
);

Параметр

OldName

Указатель на null-terminated (оканчивающуюся нулем) строку, которая задает имя переименовываемого объекта.

NewName

Указатель на null-terminated (оканчивающуюся нулем) строку, которая задает новое имя объекта без номера драйва (диска).

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

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_FILE, FR_NO_PATH, FR_INVALID_NAME, FR_DENIED, FR_EXIST, FR_WRITE_PROTECTED, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_LOCKED, FR_NOT_ENOUGH_CORE

Описание

Переименовывает объект (файл или директорию) и также может перенести его в другую директорию. Номер логического диска определяется по старому имени (первый параметр функции), и новое имя (второй параметр) не должно содержать логический номер диска. Не переменовывайте открытые объекты.

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

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

Пример кода

    /* Переименовываем объект */
    f_rename("oldname.txt", "newname.txt");
    /* Переименовываем и переносим объект в другую директорию */
    f_rename("oldname.txt", "dir1/newname.txt");