FatFs文件系统:f_rename

网站作者1年前FatFs23707

重命名一个对象。

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

相关文章

FatFs文件系统:f_close

关闭一个打开的文件。FRESULT f_close (      FIL* FileObject /* 文件对象结构的指针 */ );参数:FileObject 指向将被关闭的已打开的文件对象结构...

FatFs文件系统:get_fattime

获取当前时间。DWORD get_fattime (void);参数:void返回值:返回的当前时间被打包进一个 DWORD 数值。各位域定义如下: bit31:25 年,从 1980 年开始算起(0...

FatFs文件系统:f_lseek

移动一个打开的文件对象的文件读/写指针。也可以被用来扩展文件大小(簇预分配)。FRESULT f_lseek (      FIL* FileObject, /* 文件对象结构指针 */     ...

FatFs文件系统:f_write

写入数据到一个文件。FRESULT f_write (      FIL* FileObject, /* 文件对象结构的指针 */      const void* Buffer, /* 存储写入...

FatFs文件系统:f_readdir

读取目录项。FRESULT f_readdir (      DIR* DirObject, /* 指向打开的目录对象结构的指针 */      FILINFO* FileInfo /* 指向文件...

FatFs文件系统:f_getcwd

获取当前目录。FRESULT f_getcwd (        TCHAR* Buffer, /* Pointer to the buffer */        UINT BufferLen ...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。