From 289f6a146c0b2087607d8d8659531ea90142779a Mon Sep 17 00:00:00 2001 From: Leo C Date: Sun, 27 May 2018 21:26:38 +0200 Subject: Import fatfs R0.13b --- fatfs/documents/doc/rename.html | 87 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 fatfs/documents/doc/rename.html (limited to 'fatfs/documents/doc/rename.html') diff --git a/fatfs/documents/doc/rename.html b/fatfs/documents/doc/rename.html new file mode 100644 index 0000000..326af0d --- /dev/null +++ b/fatfs/documents/doc/rename.html @@ -0,0 +1,87 @@ + + +
+ + + + + +The f_rename function renames and/or moves a file or sub-directory.
++FRESULT f_rename ( + const TCHAR* old_name, /* [IN] Old object name */ + const TCHAR* new_name /* [IN] New object name */ +); ++
+FR_OK, +FR_DISK_ERR, +FR_INT_ERR, +FR_NOT_READY, +FR_NO_FILE, +FR_NO_PATH, +FR_INVALID_NAME, +FR_EXIST, +FR_WRITE_PROTECTED, +FR_INVALID_DRIVE, +FR_NOT_ENABLED, +FR_NO_FILESYSTEM, +FR_TIMEOUT, +FR_LOCKED, +FR_NOT_ENOUGH_CORE +
+Renames a file or sub-directory and can also move it to other directory in the same volume. The object to be renamed must not be an open object, or the FAT volume can be collapsed. Such the wrong operation is rejected safely when file lock function is enabled.
+Available when FF_FS_READONLY == 0 and FF_FS_MINIMIZE == 0.
++ /* Rename an object in the default drive */ + f_rename("oldname.txt", "newname.txt"); + + /* Rename an object in the drive 2 */ + f_rename("2:oldname.txt", "newname.txt"); + + /* Rename an object and move it to another directory in the drive */ + f_rename("log.txt", "old/log0001.txt"); ++