+FRESULT f_rename (
+ const TCHAR* old_name, /* [IN] Old object name */
+ const TCHAR* new_name/* [IN] New object name */
+);
+
+
+
+
+
Parameters
+
+
old_name
+
Pointer to a null-terminated string that specifies an existing file or sub-directory to be renamed.
+
new_name
+
Pointer to a null-terminated string that specifies the new object name. The drive number specified in this string is ignored and one determined by old_name is used instead.
Renames a file or sub-directory and can also move it to other directory within the same logical drive. Do not rename open objects or directry table can be broken.
+
+
+
+
+
QuickInfo
+
Available when _FS_READONLY == 0 and _FS_MINIMIZE == 0.
+
+
+
+
+
Example
+
+ /* Rename an object */
+ f_rename("oldname.txt", "newname.txt");
+
+ /* Rename and move an object to other directory */
+ f_rename("oldname.txt", "dir1/newname.txt");
+