FatFs文件系统:f_rename
重命名一个对象。
FRESULT f_rename ( const XCHAR* OldName, /* 原对象名的指针 */ const XCHAR* NewName /* 新对象名的指针 */ );
参数:
OldName'\0'结尾的字符串的指针,该字符串指定了待被重命名的原对象名。
NewName'\0'结尾的字符串的指针,该字符串指定了重命名后的新对象名,不能包含驱动器号。
返回值:
FR_OK (0)函数成功。
FR_NO_FILE 找不到原名。
FR_NO_PATH 找不到路径。
FR_INVALID_NAME 文件名无效。
FR_INVALID_DRIVE 驱动器号无效。
FR_NOT_READY 由于驱动器中没有存储介质或任何其他原因,而导致磁盘驱动器无法工作。
FR_EXIST 新名和一个已存在的对象名冲突。
FR_DENIED 由于任何原因,而导致新名不能被创建。
FR_WRITE_PROTECTED 存储介质被写保护。
FR_DISK_ERR 由于底层磁盘 I/O 函数中的错误,而导致该函数失败。
FR_INT_ERR 由于一个错误的 FAT 结构或一个内部错误,而导致该函数失败。
FR_NOT_ENABLED 逻辑驱动器没有工作区。
FR_NO_FILESYSTEM 磁盘上没有有效的 FAT 卷。
描述:
f_rename 函数当_FS_READONLY == 0 并且_FS_MINIMIZE == 0 时可用。
f_rename 函数重命名一个对象,并且也可以将对象移动到其他目录。逻辑驱动器号由原名决定,新名 不能包含一个逻辑驱动器号。不要重命名打开的对象。
示例:
/* 重命名一个对象 */ f_rename("oldname.txt", "newname.txt"); /* 重命名并且移动一个对象到另一个目录 */ f_rename("oldname.txt", "dir1/newname.txt");