最新版 FatFS f_rename 详解

最新版 FatFS f_rename 详解

作者:fly 发布于:2014-3-24 16:34 分类:嵌入式

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");


发表评论:

 
Powered by emlog sitemap